Using 

HP-UX 

HP 9000 Computers 


¥A^ HEWLETT 
WfcM PACKARD 

HP Part No. A1700-90014 
Printed in USA Jannary 1995 


E0195 



Legal Notices 

The information contained in this document is subject to change without notice. 

Hewlett-Fhckard makes no warranty of any kind with regard to this manual, 
including, but not limited to, the implied warranties of merchantability and 
fitness for a particular purpose Hewlett-Packard shall not be liable for errors 
contained herein or direct, indirect, special, incidental or consequential damages 
in connection with the furnishing, performance, or use of this material. 

Warranty. A copy of the specific warranty terms applicable to your 
Hewlett-Packard product and replacement parts can be obtained from your local 
Sales and Service Office. 


Copyright © 1983-1995 Hewlett-Packard Company 
Copyright © 1980, 1984, 1986 UNIX System Laboratories, Inc. 

Reproduction, adaptation, or translation without prior written permission is 
prohibited, except as allowed under the copyright laws. 

Restricted Rights Legend. 

Use, duplication, or disclosure by the U.S. Government is subject to restrictions 
as set forth in sub-paragraph (c)(l)(ii) of the Rights in Technical Data and 
Computer Software clause in DEARS 252.227-7013. 

Hewlett-Packard Company 
3000 Hanover Street 
Palo Alto, CA 94304 U.S.A. 

Rights for non-DOD U.S. Government Departments and Agencies are as set forth 
in FAR 52.227-19(c)(l,2). 

All rights reserved. 

Trademark Acknowledgement. 

UNIX is a registered trademark in the United States and other countries, 
licensed exclusively through X/Open Company Limited. 



Printing History 

The printing date will change when a new edition is printed. Minor changes 
may be made at reprint without changing the printing date. The manual part 
number will change when extensive changes are made. 

Manual updates may be issued between editions to correct errors or document 
product changes. To ensure that you receive these updates or new editions, see 
your HP sales representative for details. 

August 1992 ... Editiou 1 ... B2910-90001 

This edition incorporates material from A Beginner’s Guide to HP-UX, Edition 
E0191, with the addition of updated material for HP-UX 9.0, HP VUE, the 
System Administration Manager, and Instant Ignition. This manual applies to HP 
9000 Series 300, 400, and 700 computers. 

January 1995 ... Edition 2 ... A1700-90014 

This edition includes information covering the 10.0 release of HP-UX. 
References to HP VUE have been removed because HP VUE information is 
contained in Using Your HP Workstation and the HP Visual User Environment 
3.0 User’s Guide. This manual applies to HP 9000 Series 800 computers. 



How to Use this Guide 

This guide covers everything you need to know to begin using your new 
Hewlett-Packard computer. It provides step-by-step instructions for basic tasks 
such as copying flies, printing documents, and sending electronic mail. 

This guide contains the following information: 

Chapter 1, Getting Started provides an overview of your system and explains 
how to log in and log out. 

Chapter 2, Working with Files and Directories shows you how to create, 
view, print, and remove flies; create and remove directories; and navigate 
between directories. 

Chapter 3, Using Your Shell explains how to use command syntax, redirect 
command input and output, and set your login environment. 

Chapter 4, Using the vi Editor describes how to create and edit text using the 
vi editor. 

Chapter 5, Using Electronic Mail shows you how to send and receive 
messages electronically. 

Chapter 6, Communicating over a Network describes how to use and 
communicate with remote systems. 

Chapter 7, Making Your System Secure covers system security and changing 
file and directory permissions. 

Glossary explains common HP-UX terms. 

Appendix A, HP-UX Quick Reference contains tables summarizing useful 
HP-UX commands. 

Appendix B, Doing Advanced HP-UX Tasks provides pointers for more 
information about advanced and system administration tasks not covered in 
this guide. 
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Typographic Conventions 

This guide uses the following typographic conventions: 

Boldface Words defined for the first time appear in boldface. For 

example, an argument is the part of a command line that 
indicates what file or directory the command is to act on. 

Computer Computer font indicates literal items displayed by the 

computer. For example: 

file not found 

User input Color indicates literal items that you type. For example: 

cd 

Italics Manual titles and emphasized words appear in italics, as do 

values that you supply. 

For example, in the command below you would 
substitute an actual directory name (such as mydir) for 
directory _name. 

cd directory_name 

A rectangle with rounded corners and a label denotes a 
keyboard key. A notation like (CTRL] +f^ indicates that you 
should hold the control key down, then press [q^. 

Select an on-screen item or a corresponding softkey. For 
example. 

Help 

shown at the bottom left side of the screen means that 
pressing the softkey corresponding to that position on the 
screen (f 1) will cause a help screen to be displayed. 


(Enter) 


Softkey 
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Getting Started 


Your new HP computer uses the HP-UX operating system. HP-UX is a versatile 
operating system that meets the computing needs of diverse groups of users. 
You can use HP-UX simply to run applications, or you can develop your own 
applications in its rich software development environment. In addition, HP-UX 
offers powerful subsystems, such as electronic mail, windows, networking, and 
graphics. 
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Overview of Your System 

Your system should be installed and ready to use. If you have not yet installed 
your system, please see the Hardware Installation Guide or Owner’s Guide that 
came with it. 

Also refer to the Owner’s Guide for instructions on starting your system, 
performing initial configuration, and adding new user accounts. 


Note Throughout this guide, you will see the term system 

administrator. The system administrator is someone who 
manages your system, taking care of such tasks as adding 
peripheral devices, adding new users, and doing system backups. 
In general, this person (who may also be called the system 
operator or something similar) is the one to go to with questions 
about implementing your software. 

However, if you are the only user on a system, then whenever 
this guide refers you to the system administrator, you should 
be able to get help from the system administration manuals 
that you purchased with your system (especially System 
Administration Tasks). Your HP support engineer can also 
provide installation and maintenance help, in accordance with 
your support contract. 

Your system includes a tool called System Administration 
Manager (SAM) that has complete online help to guide you 
through system administration tasks. Use SAM only if a system 
administrator is not available. To start SAM, log in as the 
superuser and type /usr/sbin/sam, then press fEnter") . For 
more information about SAM, see the System Administration 
Tasks manual. 


Using HP-UX Commands 

Most of this guide assumes you will be using the POSIX, Bourne, or Key shells. 
(Details on the C shell can be found in the Shells: User’s Guide.) With these 
shells, you run a command by typing the command’s name on a command line 
and pressing the fEnter") key. Note that fEnter") is the same as fRetum") on some 
keyboards. 

For example, you can run the date command by typing: 
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datS (Enter) 

Wed Oct 26 13:15:04 MDT 1994 

The rest of this guide explains how to use HP-UX commands, and Chapter 3 
explains shells. To get visual help directly from the screen while you are 
working with commands, see the following sections. 

The Key Shell: Visual Help for Commands 

The Key Shell gives you help on most HP-UX commands by displaying softkey 
command names and options in sequence. You can select from these and let the 
Key Shell build your command lines “in English” before you have mastered the 
commands and command syntax of HP-UX. For more information, see “Entering 
Commands with the Key Shell” in Chapter 3, and the Shells: User’s Guide. 

TSM: Window-Like Functions for Terminal Users 

TSM (“Terminal Session Manager”) allows you to run multiple HP-UX programs, 
each in its own session, on your terminal. TSM provides an easy method for 
switching quickly between these sessions. Thus, TSM provides some of the 
functionality of a windowing system like HP Visual User Environment or X 
Windows. For more information on TSM, see Terminal Session Manager: User’s 
Guide and the tsm{\) manual reference page in the HP-UX Reference. 

HP VUE: the Visual User Environment 

Client computers can use the HP Visual User Environment (VUE). HP VUE is a 
powerful graphical environment that provides an interface to HP-UX. It has 
several components that help you use your system faster and more intuitively: 

■ Windows are containers on the screen for applications; they let you run more 
than one application at a time. 

■ Workspaces allow you to have the equivalent of up to six different screens, 
although only one screen is displayed at a time. It’s as though your display 
had several layers that you can shuffle. Workspaces provide a way to organize 
your work. 

■ Icon-based file management. Files are represented by icons that can be 
selected and moved. 

■ Front Panel controls and toolboxes for easy access to applications. 

■ Extensive online help, provided by the HP Help Manager. 

■ Session management. HP VUE remembers which applications were running 
when you logged out and restarts them the next time you log in. 
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■ Easy customization for colors, fonts, window behavior, and other aspects of 
the appearance and behavior of your workstation’s interface. 

■ Multimedia (images and audio) applications for playing, recording, and editing 
audio, and capturing and viewing images. 

For information about HP VUE, see Using Your HP Workstation or the HP 
Visual User Environment 3.0 User’s Guide. 
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Logging In and Ont of HP-UX 

This section explains how to log in and log out using the command line. 

Get your user name and password from the system administrator or the 
support person who installed your system. 


Note The root user, or superuser, is a special user. When logged in as 

the superuser, you have the permission required to perform all 
system administration tasks. Normally, the system administrator 
is the only one who logs in as the superuser. If you are not the 
system administrator, you will not log in as the superuser to 
perform daily tasks. 

However, the very first time you (or anyone else) log into 
your new workstation, you must do so as root (root is the 
user name for the superuser). This is because no other user 
accounts have been created yet. Once accounts have been 
created for other users, you should log out as superuser, then log 
back in as one of those users. 


Logging In 

You will see a login prompt: 


Console Login: | 

Type your user name at the login prompt. 

Logging in gives you a secure way to access your system. You log in by typing a 
user name and a personal password. 

1. If you have a user account, type your user name after the login: prompt 
and press (Enter") . 

For example: 

leslie ("Enter") 


If you don’t have a user account yet, ask your system administrator to create 
one, or follow the instructions in your Owner’s Guide. Until you get a user 
account, you may log in as superuser. 
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To log in as superuser, type the following at the login: prompt: 
root [Enter] 

2. If you are logging in with your own user name, or if a password has been set 
for root, you must enter the correct password at the Password: prompt. 
Type the password and press fEnter) . 

The password does not appear on the screen. 

3. The copyright notice appears briefly, followed a message asking about your 
console type. Type y and press fEnter) . 

4. if you logged in with your user name, lines similar to these appear: 

TERM = (hp) 

$ 

if you logged in as superuser, lines similar to these appear: 

Value of TERM has been set to "hp". 

WARIIIG: YOU ARE SUPERUSER !! 

# 

Remember to get a user account for yourself (ask your system administrator, 
or see your Owner’s Guide). 

You are now logged in. 
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Logging Out 

After you are done working for the day, you should log out. Logging out 
prevents other users from accessing your system. However, it does not prevent 
others from accessing your work over the network—to protect your work, see 
Chapter 7. 

1. If you are using any applications, save your work, then exit the application. 

2. Type exit and press [Enter") . If you have several work sessions (shells) 
opened, you may have to type exit several times before you return to the 
login prompt. 

After logging out, do not turn your computer off. Your computer is a multi-user 
system, and other people may be using it. If you turn it off, you will deny 
them access to the computer, and may cause them to lose some of their work. 

If you have to turn off your computer, see System Administration Tasks for 
information on shutting down. 
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Changing Yonr Password 

A password must contain at least six characters. At least two characters must 
be alphabetic, and one of those characters must be a number or a special 
character (such as a dash (-), an underline (_), or an asterisk (*)). The password 
cannot contain your user name, or even a reversed version of your user name 
(for example, if your user name is dim your password cannot contain mid). Also 
see “Choosing a Secure Password” in Chapter 7. 

Examples of valid passwords are: wild-life, ! secret, and *fuzzy*. 

Make sure you do not forget the password you use. If you forget your password, 
contact your system administrator, or log in as the superuser and set a new 
password with the SAM utility. 

From a command line shell prompt, you can use the passwd command to set or 
change a password. Type: 

passwd 

You will be prompted for your old password. Then you will be prompted to 
enter and re-enter your new password. The re-entered password must match 
the first entry. 

Use the same procedure to change an old password as to add a new password. 
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Modifying System Parameters 

Use this section only if you need to add or modify the system parameter 
information that was set the first time you turned on your system (see your 
Owner’s Guide for details). Such modifications should be made as soon as 
possible after initial installation. 

Log in as the superuser and type the following command: 

/sbin/set_parms option fEnter] 

Where option is one of the following: 


Option ... 

hostname 
timezone 
ip_address 
addl_netwrk 
font_c-s 


Modifies or sets ... 

System host name 
Time zone 

Internet Protocol address 
Additional network parameters 
Network font service 


Any changes you make in set_parms will take effect after rebooting the system. 
You can also use SAM to add or change most of this information. 
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Information Abont Yonr System 

Manuals 

This section lists some useful HP-UX and HP VUE manuals. For a complete list, 
see the manuals{l) manual reference page. 

Within the United States, you can order any of the following manuals by calling 
Hewlett-Packard at 1-800-227-8164. In other countries, contact your nearest HP 
Sales and Support office. 

These manuals are also available on CD-ROM, with the optional HP-UX 
LaserROM product. For information on LaserROM, contact your HP Sales and 
Support office. 

System Installation 

■ If you need help with system hardware installation, see the Owner’s Guide 
for your system. 

■ If you need help with peripheral installation, see the Owner’s Guide for your 
system. 

■ If you have not yet installed your HP-UX system, see Installing HP-UX 10.0, 
HP part number B2355-90050. 

HP-UX Usage and Administration 

■ For general usage of HP-UX, continue reading this guide. 

■ For HP-UX system administration and troubleshooting information, see the 
System Administration Tasks manual, HP part number B2355-90051. 

For most system administration tasks, you can use the SAM tool (log in as 
superuser by typing root, enter the superuser password, then type sam). 

SAM contains an extensive online help system to help you perform system 
administration tasks. 

HP VUE Usage and Administration 

■ For basic HP VUE information, see Using Your HP Workstation or HP Visual 
User Environment 3.0 User’s Guide, HP part number B1171-90079. 

■ For advanced HP VUE configuration and system administration, see the HP 
Visual User Environment 3.0 User’s Guide. 
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X Window System 

■ See Using the X Window System, HP part number B1171-90076. 

Displaying the HP-UX Manual Reference Pages 

The HP-UX Reference contains reference entries (also called manual pages or 
“man pages”) for every HP-UX command. 

These manual reference pages provide command syntax and a detailed 
description of the command and its options and arguments. The description 
may include examples of command usage and provide other information such as 
system files used and related commands. 

To display the man pages from the command line, type man command^name at 
the command prompt. For example, to learn more about the cp command type: 

man cp 

After a few seconds, an information display appears. For command syntax, refer 
to the “SYIOPSIS” section of the man page. Brackets, [ ], in a syntax statement 
indicate that the enclosed parameter is optional. 

To print a man page, type the following: 

man command^name \ col -b | Ip 

The col -b filters and formats the man page, and the Ip command sends it to 
the default printer. 

You can even look at the man man page to learn more about the man command 
itself: 
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f -\ 

man man 

man(l) man(l) 

NAME 

man - find manual information by keywords; 
print out a manual entry 

SYNOPSIS 

man -k keyword. . . 
man -f file... 

man [-] [section[subsection]] entry_name... 
DESCRIPTION 

man accesses information from the online 
version of the HP-UX Reference. It can be 
used to: 

- More -(117.) 

V_ 


The message - More -(117) means you have viewed 11% of the file, and 89% 
remains. (Some systems will just display - More -). At this point, you can do 
any of the following: 

■ Scroll through the file a page at a time by pressing the space bar. 

■ Scroll through the file a line at a time by pressing ("Enter") . 

■ Quit viewing the man page by pressing (^. 
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Where to Go Now 

If you want to ... 


Turn to this chapter . .. 


Work with flies and directories 2 

Use shell commands and processes 3 

Edit flies 4 

Use electronic mail 5 

Use remote systems 6 

Make your system secure 7 

See a quick reference for HP-UX tasks Appendix A 

Do advanced or system administration Appendix B 
tasks 
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Working with Files and Directories 


A file is a named area on your system containing stored information. A 
directory is a kind of file that can contain other files and directories. You can 
use HP-UX commands and applications to create files for text or data. 
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Creating a File 

You can use the cat command to create a tile containing text. For example, to 
create the tile “myflle”, use the cat command as follows: 

cat > myfile 

After you type this command, the cursor sits on the first line of the empty file. 
Type your text and press fEnter") at the end of each line. To exit the file, hold 
down fcTRL] and press The cat command returns you to the command line 
prompt. 

You can use the cat command to create your own version of myfile. For 
example, you might create the file as follows: 

cat > myfile 

The text I am typing will be stored in "myfile". f Enter] 

1 press RETURN at the end of each line. f Enter ] 

When I’m finished, 1 hold down the CTRL key and press D. fEnterJ 
fCTELj -fp) 

You can also create and edit files using a text editor such as vi. To learn how to 
use this editor, see Chapter 4. 
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Listing Files 

To verify that cat created myfile, run the Is command, which lists the names 
of your files. Running the Is command with the file name will confirm that the 
file exists, but won’t list other files. 

Is myfile 

myfile The Is command lists myfile. 

Viewing the file’s contents is discussed in “Viewing and Printing Files” in this 
chapter. 

Another command that lists the names of file and directories is the 11 (tong 
dsting) command. This command produces a list of the file and directory names, 
along with information about who has access to each file and directory. For 
more information about the 11 command and access permissions, see “Using the 
11 Command to Display Access Permissions” in Chapter 7. 
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Naming Files 

When you choose a file name, you need to follow certain rules regarding the 
length of the name and the types of characters you include. If a file name 
begins with a dot (.), it is “invisible” and the Is command normally will not list 
it. To see invisible file names, run Is with the -a option. 

Guidelines for File Names 

When you choose a file name, remember these rules: 

■ Generally, file names can contain up to 256 characters (or bytes, in non-ASCII 
character sets). These characters can be any combination of the following: 

□ Uppercase or lowercase letters (A through Z; a through z) 

□ Digits (0 through 9) 

□ Special characters, such as: +, -, _, . 

Based on these rules, the following are valid file names: 

money Acct.01.87 CODE.c 

lost+found 112.3-data foo_bar 

■ HP-UX interprets uppercase and lowercase letters differently in file names. 
Thus, the following file names all are different: 

money Money MoneY MONEY 


Note On some computers, file names cannot be longer than 14 

characters, if you are not sure if your computer can support 
longer file names, check with your system administrator. 


Invisible File Names 

A file name in which the first character is a dot (.) is an invisible file name, 
since the Is command does not normally display it. Use invisible file names if 
you don’t want or need certain flies displayed when you run Is. 

To illustrate, you have an invisible startup file that the system runs when you 
log in, a login script, it is used to customize your working environment. To 
learn more about login scripts, see “Using Login Scripts to Set the System 
Environment” in Chapter 3. 
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To cause Is to list invisible file names, including the name of your login script, 
run it with the -a option: 

Is -a Use -a to see invisible file names. 

.profile myfile This is the POSIX Shell, so .pro¬ 

file is shown. 
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Viewing and Printing Files 

Using the more command, you can view a text tile one screenful at a time. If 
your system is appropriately configured, you can print a text file using the Ip 
command. 

Viewing a File with more 

The more command displays a text file’s contents on the screen. For example, 
the following more command displays the contents of myf ile (which you 
created in “Creating a File”): 

more myfile 

The text I am typing will be stored in "myfile". 

1 press RETURN at the end of each line. 

When I’m finished, 1 hold down the CTRL key and press D. 

If the file contains more lines than are on your screen, more pauses when the 
screen is full. With a longer file, press (space") to continue looking at additional 
screens, and press when you are finished. Then more returns you to the 
system prompt. 

Try running more on the system file /etc/passwd: 


■ 

root:X0SDMfBA.hqs6:0:3::/:/usr/bin/sh 
daemon:*:1:5::/:/usr/bin/sh 
bin:*:2:2::/bin:/usr/bin/sh 
adm:*:4:4::/var/adm:/usr/bin/sh 


--More--(4"/,) 


The “—More—(4"/.) ” message at the bottom of the screen means you have 
viewed 4% of the file thus far, and 96% of the file remains to be viewed. At this 
point, you can do any of the following: 

■ Scroll through the file a page at a time by pressing the space bar. 

■ Scroll through the file a line at a time by pressing fEnter") . 

■ Quit viewing the file and leave more by pressing 
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Displaying the First and Last Lines of a File 

■ To see the first fine of a file without using a text editor, use the head 
command: 

head filename 

This will display, by default, the first ten fines of filename, including blanks. 
For example: 

COIFEREICE MOTES 


Attendees: 

Mary 

Sam 

Nina 

George 

Raphael 

Sergei 

■ To see the last ten fines (default value) of your file, use the tail command: 
tail filename 

You will see the last ten lines (including blanks) of filename. 

Both head and tail take numeric arguments. For example, use this command to 
display the first 25 lines of f ilel: 

head -25 filel 


Printing a File with Ip 

You can print a text file using the Ip (fine printer) command. For example: 

Ip myfile 

The Ip command displays a message indicating that it sent your file to the 
printer. For example: 

request id is Ip-number (1 file) 

The number is an ID number assigned to the print job by the Ip command, if 
you don’t see this message, or if you get an error message, consult your system 
administrator. You should get a printout with your username displayed on the 
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first page. The time required for a printout depends on the number of tasks 
being run by the system and the speed of the printer itself. 

To configure printers and set up the Ip spooler, use the System Administration 
Manager (SAM). For command-line printer configuration, see the Configuring 
HP-UX for Peripherals manual. For command-line spooler configuration, see the 
System Administration Tasks manual. 

Getting Printer Information with Ipstat 

To display a report on the printer status, including the order of your print job in 
the printer queue, type: 

Ipstat -t 

Canceling a Print Reqnest with cancel 

To cancel a print request, enter the cancel command with the ID number of 
your request: 

cancel requestfid 
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Renaming, Copying, and Removing Files 

To change a file’s name, use the mv {“move”) command; to make a copy of a 
file, use the cp (“copy”) command; to remove a file, use the rm (“remove”) 
command. 

Renaming Files with mv 

Using the mv command, you can rename the file myf ile to foof ile as follows: 
mv myfile foofile 

To verify that mv renamed the file, use the Is command: 

Is 

foofile 

To rename foofile back to myfile, type: 
mv foofile myfile 

Is Using Is, verify that the 

myfile action was successful. 


Cantion When renaming files, take care not to rename a file to the name 
of a file that already exists in that directory. If you do this, the 
file that already has the name will be lost. To ensure that you 
do not accidentally remove an existing file, use the -i option. 
For example: 

mv -i myfile foofile 

If foofile exists, the above command asks for confirmation 
before removing it. 


The mv command can also be used to move files to different locations on the 
system. See “Moving and Copying Files between Directories”. 

Copying Files with cp 

Copy a file when you want to make a new version of it while still keeping 
the old version around. For example, to make a new copy of myfile named 
myfile2,type: 

cp myfile myfile2 
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Now when you use the Is command, you will see the following: 

Is 

myfile myfile2 

Use more to view myf ile2. You will find that it is the same as myfile. 


Caution If you copy a file to an existing file, the existing file will be lost. 

To ensure that you never accidentally overwrite an existing file, 
use the -i option. For example, if you attempt to copy myfile 
to myf ile2 in the current directory and myf ile2 already exists, 
cp asks for permission to overwrite myf ile2: 

cp -i myfile myfile2 
overwrite myfile2? (y/n) 


Removing Files with rm 

If you have files that are no longer needed, you should remove (delete) them. 
Deleting unnecessary files leaves more room for other files on your system. For 
example, suppose you have finished using myf ile2, and it is no longer needed. 
To remove myf ile2, type: 

rm myfile2 

To see that myf ile2 was removed, use Is: 

Is 

myfile The directory listing shows the remaining file 

To cause the rm command to prompt you for permission before deleting any file, 
use the -i option: 

rm -i myfile 
myfile: ? (y/n) 

See “Removing Directories” for information on how to remove directories and 
contents. 
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Comparing the Contents of Two Files 

If two text flies are known to be similar, and you want to determine what the 
differences are or which one has been changed: 

1. First run 11 and look at the date and time fields showing when each file was 
last saved. For example: 

-r¥-r—r— 1 jth users 1759 Mar 17 15:53 testl 

-r¥-r—r— 1 jth users 2130 Mar 17 15:47 test2 

testl was saved more recently than test2, because it has the more recent 
time (and its size was also changed). 

2. You can determine the differences between testl and test2 by running the 
diff command: 

diff testl test2 


For example, if testl contains: 


Mary had a little lamb. 

Its fleece was 
white as snow. 

And test2 contains: 

Mary had a little lamb. 

Its fleece was 
blue as sky. 

The command will display something like the following indicating the 
differences it found, by line number, and (with the < and >) pointing to which 
file the difference occurred in: 


3c3 The relevant line numbers 

< white as snow. The version in testl 


> blue as sky. 


The version m test2 
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Joining Two Files 

To append to an existing tile, you use the cat command with two greater-than 
signs (>>). The tile name following the >> identities the tile to which the 
contents of the first file is appended. If that file exists, the new data is 
appended to the end of the file. If the file does not exist, it is created. The 
command format is: 

cat filename2 » filenamel 

where Jilename2 is the file whose output is redirected, snh filenamel is the 
name of the file that is appended to. 

This also works with the output of commands. The following example executes 
the date command with the output redirected to append to the who is on file: 


date 

>> whoison 




Append output to 






whoison. 

more 

whoison 




Display contents of 






whoison. 

pat 

console 

Oct 

4 

08:50 

Output from 

terry ttyOl 

Oct 

4 

11:57 

previous example. 

kim 

tty02 

Oct 

4 

08:13 


Tue 

Oct 4 13:20 

i:16 

MDT 

' 1994 

Newly appended out 


put from date. 
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Understanding a Directory Hierarchy 

HP-UX directories can contain flies and other directories. In addition, directories 
are hierarchically organized. That is, a directory has a parent directory “above” 
and may also have subdirectories “below” (child directories). Similarly, each 
subdirectory can contain other flies and also can have more subdirectories. 
Because they are hierarchically organized, directories provide a logical way to 
organize flies. 

With the help of directories, you can organize your flies into manageable, 
logically related groups. For example, if you have several flies for each of 
several different projects, you can create a directory for each project and store 
all the flies for each project in the appropriate directory. 

The structure of an HP-UX directory resembles an inverted tree. These 
directories (shown in the figure below as ovals) usually contain more directories; 
thus, the typical home directory develops a branching tree structure. 


Working with Files and Directories 


2-13 




A Typical HP-UX Directory Structure 


Each directory also contains flies (represented below as boxes), which hold 
actual text, data, or code. At the top of the inverted tree structure is the root 
directory, represented in path names as /. This flgure shows a broader part of 
a system’s directory structure. 
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A System Directory Structure 
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Determining Your Location in an HP-UX Directory 
Hierarchy 

This section discusses the HP-UX directory structure and how you specify 
the location of a file in the structure. All directories fall under the topmost 
root directory, which is denoted by a slash (/). When you use HP-UX, you are 
working in a directory called the current working directory. And when you 
log in, HP-UX places you in your home directory. 

The figure below shows the two highest levels of a typical HP-UX directory 
structure. Each directory, including the root, may contain logically organized 
files, as well as more directories. 



If you want to know more about the contents of Typically, users’ 

these directories, refer to the System Adminstration home directories 
Tasks Manual. are under here. 

The HP-UX Directory Structure 

Here is a sample directory hierarchy for a user named Leslie. When Leslie logs 
in, she is in her home directory, leslie. 
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To determine your location in the directory hierarchy, use the pwd (print 
morking directory) command. The pwd command displays the “path” from the 
root directory to your current working directory. 

For example: 

pwd 

/home/engineers/leslie 
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Specifying Files and Directories 

When specifying flies in your current working directory, you can refer to them 
just by their file names. But when referring to directories and flies outside your 
current working directory, you must use path names, which tell HP-UX how to 
get to the appropriate directory. 

Absolute Path Names 

Absolute path names specify the path to a directory or file, starting from the 
root directory at the top of the inverted tree structure. The root directory is 
represented by a slash (/). The path consists of a sequential list of directories, 
separated by slashes, leading to the directory or file you want to specify. The 
last name in the path is the directory or file you are pointing to. 

Here is an example of an absolute path, displayed with the pwd command: 

pwd 

/home/engineers/leslie 

This specifies the location of the current directory, leslie, by starting from the 
root and working down. 

The figure below shows the absolute path names for various directories and files 
in a typical directory structure: 
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/home/engineers/sally/reports 

Absolute Path Names 

Relative Path Names 

You can use a relative path name as a shortcut to the location of flies and 
directories. Relative path names specify directories and flies starting from your 
current working directory (instead of the root directory). 

This relative path Means ... 

name ... 


The current directory. 
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The parent directory (the directory above the 
current directory). 

. . / . . Two directories above the current directory. 

directory_name The directory below the current directory. 

For example, suppose the current directory is /home/engineers/leslie. To list 
the flies in the directory above (which is /home/engineers), enter: 

Is . . 

arnie leslie sally 

To list the flies in a directory immediately below your current directory, 
simply enter the directory name. For example, to list the flies in the projects 
directory, below the current directory /home/engineers/leslie, enter: 

Is projects 

$ The projects directory is empty. 

The following figure shows relative path names for various directories and flies 
starting from the current directory, /home/engineers/leslie. 
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. ./arnie/hisfile myfile projects ../sally/herfile 

Relative Path Names from 
/home/engineers/leslie 
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Creating Directories 

To create a directory, use the mkdir (make directory) command. After you 
create a directory, you can move flies into it, and you can even create more 
directories underneath it. For example, to create a subdirectory in your current 
working directory named projects, type: 

mkdir projects 

To verify its creation, you can use either the Is or Isf command to list the 
contents of the directory. Both commands display the new directory, but Isf 
appends a slash (/) to the end of directory names to differentiate them from file 
names. For example: 

Is 

myfile projects It did what you expected. 

Isf 

myfile proj ects/ The Isf command appends a slash to directory names. 
This figure shows the resulting directory structure under /home/engineers: 



Creating the “projects” Directory 


Use mkdir as follows: 
mkdir new_dir_path 

where new_dir_path is the path name of the directory you want to create. For 
example, to create two directories named old and new under the projects 
directory, type: 

mkdir projects/old 
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mkdir projects/new 
Isf projects 
new/ old/ 



Structure after Creatiug New Directories 
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Changing Yonr Cnrrent Directory 

To change your current working directory, use the cd command. For example, 
cd projects moves you into the directory projects (which you created in 
“Creating Directories”). 

To verify your location, use the pwd command, which displays your current 
directory. For example, if your home directory was /home/leslie and you ran 
the “cd projects” command, pwd would display the following: 

pwd 

/home/leslie/proj ects 

To move into the directory new under projects, type: 
cd new 

pwd Verify where you are. 

/home/leslie/proj ects/new 

Remember that . . is the relative path name for the parent directory of your 
current working directory. So to move up one level, back to projects, type: 

cd . . 

pwd Show your current working directory. 

/home/leslie/proj ects It was successful. 

Experiment with the cd and pwd commands to move around your directory 
structure, if you become lost, don’t panic; just remember that you can type cd 
to return to your home directory. For example: 

cd 

pwd Are you back home? 

/home/leslie i^s! 

The following figure illustrates how various cd commands change your current 
working directory. The example assumes you’re starting at the directory 
/home/leslie/projects, and that your home directory is /home/leslie. 
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You can also get to any directory using its absolute path name. For example, to 
change to the projects directory in the example hierarchy, enter: 

cd /home/leslie/projects 
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Moving and Copying Files between Directories 

The mv command lets you move a file from one directory to another. With the 
cp command, you can copy a tile into a different directory. 

Moving Files 

To move flies from one directory to another, use the mv command, 
mv from^path to^path 

where from^path is the file name or path name of the file you want to move, 
and to^path is the name of the path where you are moving the file. For 
example, to move myf ile into the projects directory, type: 

cd Move to home directory first. 

mv myfile projects 

A single dot (.) for a path name represents your current working directory. So, 
to move myf ile from the projects directory back to your current working 
directory, type: 

mv proj ects/myf ile . Don’t forget the dot. 


Caution When renaming flies, take care not to rename a file to the name 
of a file that already exists in that directory, if you do this, the 
file that already has the name will be lost. To ensure that you 
do not accidentally remove an existing file, use the -i option. 
For example: 

mv -i myfile /home/leslie/foofile 

if /home/leslie/f oof ile exists, the above command asks for 
confirmation before removing it. 


Copying Files 

To copy a file into a different directory, use the cp command, 
cp from^path to^path 

where from^path is the file name or path name of the file you want to copy, and 
to^path is the path name of the directory or file to which you are copying. 
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For example, to make a copy of myf ile named myf ile2 in the projects 
directory, type: 

cp myfile projects/myfile2 
Isf 

myf ile projects/ Thefilemyf He still exists. 

Isf projects 

myfile2 new/ old/ The copy (myfile2j is 

in proj ects. 

To make a new version of myfile2 named myf ile3 in your current directory, 
type: 

cp projects/myfile2 myfileS 
Isf 

myfile myfileS projects/ 


Caution if you copy a file to an existing file, the existing file will be lost. 

To ensure that you never accidentally overwrite an existing 
file, use the -i option. For example, if you attempt to copy 
/home/leslie/myf ile tomyfile2 in the current directory and 
myf ile2 already exists, cp asks for permission to overwrite 
myfile2: 

cp -i /home/leslie/myfile myfile2 
overwrite myfile2? (y/n) 
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Copying Directories 

To copy entire directories, use the -r option of the cp command. 

For example, if you have a directory called mydir that contains myf ile and 
newf ile, you can copy the directory to a new directory called mydir2. mydir2 
will also contain a copy of myf ile and newf ile. Use the following command: 

cp -r mydir mydir2 

The -r option copies any files and subdirectories below the specified directory. 


Note If the destination directory already exists, the directory you 

are copying will become a subdirectory under the existing 
destination directory. If the destination directory does not exist, 
it will be created. 
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Removing Directories 

You can remove an empty directory with the rmdir command. To remove a 
directory and all of its contents in one step, use the rm command with the -rf 
option. 

After you have removed a directory, you can no longer use it, and it will no 
longer appear in an 11 or other listing of the directory above it. 

Removing a Directory with rmdir 

Before removing a directory with rmdir, you must remove any visible or 
invisible files and any directories under it. For example, suppose you want to 
remove the projects directory and its files: 



The “projects” Directory Structure 


To remove this structure, run the following sequence of commands: 

cd Move back to your home 

directory 

Isf List the files and 

myfile myfileS projects/ directories. 

rmdir projects toremofcprojects. 
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rmdir: projects not empty 

cd projects 

Isf 

myfile2 new/ old/ 

rm myfile2 

Isf 

new/ old/ 
rmdir new 

Isf 

old/ 

rmdir old 

Isf 

cd 

rmdir projects 
Isf 

myfile myfileS 


It won’t let you. 

Change directory to pro j ects. 
List its contents. 

Removefile my f i 1 e 2. 

Check if it is gone. 

Remove directory new. 

If it’s empty, rmdir re¬ 
moves it. 

Check if it is gone. 

Now remove the old di¬ 
rectory. If empty, rmdir 
removes it. 

There is no message; 
the action was successful 
Now move back to your 
home directory. 

Verify that it worked. 


Removing a Directory and Contents with rm -rf 

To avoid having to empty a directory before removing it, you can remove a 
directory and all its files and directories in one action by typing the following: 

rm -rf dirname 


Caution Use rm -rf with great caution, since it does remove a directory 
and all its contents, irretrievably, in one action. 
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File Name Shorthand: Wildcard Characters 

Wildcard characters provide a convenient shorthand for specifying multiple file 
or directory names with one name. Two of the most useful wildcard characters 
are * and ?. The * matches any sequence (string) of characters (including no 
characters), and the ? matches any one character. 

The * Wildcard 

The * wildcard means “any characters, including no characters.” Suppose you 
have created the following files in your current working directory: 

Isf 

myfile myfile2 myfileS xenic yourfile 

To list only the file names beginning with “myfile”, type: 

Isf myfile* 

myfile myfile2 myfileS 

To list file names containing “file”, type: 

Isf *file* 

myfile myfile2 myfileS yourfile 


The ? Wildcard 

The ? wildcard means “any single character.” Although you probably won’t use 
the ? wildcard as much as *, it is still useful. For instance, if you want to list 
only the files that start with myfile and end with a single additional character, 
type: 

Isf myfile? 
myfile2 myfileS 

The ? wildcard character matches exactly one character. Thus, myfile didn’t 
show up in this listing because it didn’t have another character at the end. 
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Using the * Wildcard Character with mv, cp, and rm 

Wildcard characters are often useful when you want to move or copy multiple 
files from one directory to another. For example, suppose you have two 
directories immediately below your current directory, named new and old, and 
these directories contain the following files: 


Isf new 

myfile myfile2 
Isf old 

myfileS myfiled 


To move all the files from the directory new into the directory old, type: 
mv new/* old 

Isf new Thefilesareno 

longer inne^. 

Isf old 

myfile myfile2 myfileS myfiled They are in the 

directory old. 

You can do a similar operation with the cp command. For example, to copy all 
the files from old into new, type: 

cp old/* new 

Similarly, you can use wildcard characters with the rm command. For example, 
to remove all the files in the directory new, type: 

rm new/* 


Caution When using wildcards, be careful not to accidentally remove 
files you need. 


For More Information ... 

See regexp{5) in the HP-UX Reference for general features of * and ?. For 
additional features relating to individual shells: if you use the POSfX Shell, see 
sh-posiofiy, if you use the C shell, see csh{l), both in the HP-UX Reference. 
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Searching for Text Patterns nsing grep 

You can use the grep (“global regular expression print”) command to search 
for a text pattern within a file or to display the names of flies that contain a 
specified text pattern. This command is useful when you want to search for 
information in flies or directories. 

The grep command looks at each line of one or more flies for a text string that 
matches a specified pattern. When it finds a matching text string, it displays the 
line in which the matching string is found. 


Searching a File for a Text String 

Suppose you have a mailing list called mailist with the contents shown below: 


Smith, Joe 
Walsen, Stacey 
Diaz, Robert 
Wang, Michael 


2345 Pine St. 

493 Winkle Ave. 
6789 Pine St. 
1832 Jackson St. 


Santa Clara, CA 
San Jose, CA 
Santa Clara, CA 
Santa Clara, CA 


if you want to extract the addresses of all the people on Pine Street, enter: 


grep Pine mailist 

The grep command lists all lines in mailist that contain the string Pine. The 
output is: 


Smith, Joe 2345 Pine St. Santa Clara, CA 

Diaz, Robert 6789 Pine St. Santa Clara, CA 

To make the search case-insensitive, use the -i option. 


Searching Multiple Files 

The grep command can be useful in other ways. Sometimes, you want to And 
information, but are not sure in which file it is located. 

Suppose you have three mailing lists, and cannot remember which contains 
Stacey Walsen’s address. Enter: 

grep ’Walsen, Stacey’ mailist mailist2 mailistS 
mailist: Walsen, Stacey 493 Winkle Ave. San Jose, CA 

The grep command displays the line containing Stacey’s address and the file in 
which it was found. Note that because it contains a space, the string must be 
surrounded by single quotes (’Walsen, Stacey’). 
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To search the entire current directory for this information, enter: 


grep ’Walsen, Stacey’ * 

See the grep{ l) man page in the HP-UX Reference for more information on using 
the grep command. 
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Searching for Files using find 

You can use the find command to search through a directory and its 
subdirectories for flies meeting certain criteria. You can then execute a 
command on the flies you’ve found. 

Finding Files that Match a Pattern 

Although the syntax of find can be complex, it may help you use HP-UX more 
productively. It is a powerful and flexible command. However, it may run 
slowly, especially if it is searching many directories. 

Suppose you want to display all flies in the current directory and its 
subdirectories that begin with d. Enter: 

find . -name ’d*’ 

The dot (.) causes find to search the current directory and its subdirectories. 
The -name option followed by a file name or a file name pattern (in this case d*) 
tells find to search for all file names that match that pattern. In this example, 
find will look for all file names beginning with d. 

Note that d* is enclosed by single quotes ’d*’. If you use a file name pattern in 
the find command, you must quote it so that the shell will interpret it correctly. 

Finding Files that are Newer than a Certain File 

Suppose you want to display all flies modified after a certain file. To display all 
flies newer thanmyfile in the /home/leslie directory and its subdirectories, 
enter: 

find /home/leslie -newer myfile 

This example can be read as follows: in directory /home/leslie and its 
subdirectories. And all flies modified after myfile. (To determine when a file 
was last modified, use the 11 command.) 
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Running Commands on Files 

You can execute commands on flies located with the find command. Let’s say 
you want to remove all flies with a . tmp extension In the current directory and 
Its subdirectories. Enter: 

find . -name -exec rm {} \; 

This example finds and displays on the screen all flies In the current directory 
and Its subdirectories that end In .tmp, then deletes these flies. The -exec 
option causes the following command (rm) to be executed. The brackets { } 
represent the flies found with the find command. The semi-colon that ends the 
exec string Is escaped with a backslash (\;). 

Using Logical Operators 

The syntax of find Includes the logical Boolean operators NOT, AND, and OR. 

To And flies that do not match a specific pattern, use the logical NOT operator, 
the exclamation mark (!). After using this operator, you must use options to 
define file attributes such as file name. Then, flies are found that do not have 
the attributes you specify. 

For example, to find all flies In /tmp that are not owned by leslie, use this 
command: 

find /tmp \( ! -user leslie \) 

The \ escapes the parentheses so that they are not Interpreted as special 
characters by the shell. 

To find flies that have two distinct attributes, use the logical AND operator, 
expression -a expression. For example, to find all directories In / that are 
owned by leslie, use this command: 

find / \( -type d -a -user leslie \) 

To find flies that have either or both of two attributes, use the logical OR 
operator, expression -o expression. For example, to remove all flies ending with 
.0 or named a.out that have not been accessed for a week, use this command: 

find / \( -name a.out -o -name ’*.o’ \) -atime +7 -exec rm {} \; 
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For More Information ... 


See t\\efind{\) man page in the HP-UX Beference for more information on using 
the find command. 
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Chapter Command Summary 


To Do This . .. 

Create a file 

Terminate keyboard input for cat 
List visible flies in current directory 
List all flies in current directory 
List flies; show directories with “/” 
View a tile 
Print a tile 

Get information on a print job 
Cancel a print job IpTw 
Rename (move) a file 
Copy a file 

Delete (remove) a file 

Change directory 

Change to home directory 

Display working directory 

Remove an (empty) directory 

Remove a directory and contents 

Search a file for a text pattern 

Search for a file and display output 
on screen 


Type This ... 

cat > filename 
fcrni -Cbl 

Is 

Is -a 
Isf 

more filename 
Ip myfile 
Ipstat 
cancel Ipno 
mv fromfile tofile 
cp fromfile tofile 
rm filename 
cd directory_path 
cd 
pwd 

rmdir directory_name 
rm -rf directory_name 
grep ’text’ filename 
find dir_path -name ’filename’ 
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3 


Using Your Shell 


HP-UX provides command interpretation programs called shells. A shell is the 
interface between HP-UX and you, the user. The shell interprets the text you 
type and the keys you press, then directs the HP-UX operating system to take 
an appropriate action. 
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Understanding Command Syntax 

HP-UX has many useful commands that will help you handle data and text, do 
system administration tasks, and find information. Most of these commands 
are easy to enter, that is, they are either a command without any arguments 
(whoami), or a command whose only argument is a file name (mkdir projects). 
HP-UX commands can also be more complex, having additional options, 
arguments, or both. 

Options change a command’s behavior. For example, in Chapter 2, you used 
the -a option to change the behavior of the Is command so you could list 
invisible file names, in general, command options are preceded by a dash (-). 
Arguments provide additional information needed by the command, such as the 
name of the file on which to run the command. 


Examples Using Options 

When used without options, the rm command removes a file without verifying 
whether you really want to remove it. Suppose, for example, your current 
working directory contains these flies: myf ile, myf ilel, myf ile2, myf ile3, 
and myf ile4. You could remove all these flies by typing this command: 


rm my* 

$ All the files are removed, no questions asked. 


To cause rm to prompt you for verification before removing each file, use the -i 
(interactive) option: 


rm -i my* 
myfilel: ? (y/n) 
myfile2: ? (y/n) 
myfileS: ? (y/n) 
myfile4: ? (y/n) 
Is 

myfile4 


y 

y 

y 

n 


Type y to remove the file. 


Or, type n to leave it alone. 
myf ile4 was not removed. 


if you are using rm non-interactively and the file does not have write permission 
(for example, with -r—r—r— permission, as displayed in a long listing), then a 
message something like this will be displayed: 


filename: 444 mode ? (yes/no) 


Respond with y if you want to remove the file. 
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Examples Using Arguments 

The cal command displays an English calendar for the current month. With 
multiple command arguments, you can specify which calendar month and year 
to display. For example, to display a calendar for February 1998, type the cal 
command as follows: 


cal 2 1998 



February 

1998 


s 

M 

Tu 

W 

Th 

F 

S 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 

25 

26 

27 

28 


Be sure to include the century, 19. If you use 98 as the argument, you will get a 
calendar for the year 98 A.D. 

Enclosing Arguments in Quotes 

When a single command argument contains embedded blanks, you must enclose 
it between quotes (’wordl word2’). For example, the following grep command 
displays all lines in myf lie containing “I am”: 

grep ’I am’ myflie 

The text I am typing will be stored in "myfile". 


Running Multiple Commands on the Same Command Line 

Occasionally, you may find it useful to run two or more commands on the same 
command line. To do so, separate the commands with a semicolon, as illustrated 
below: 

whoami ; date 

leslie Output from \iho ami 

Fri Oct 7 15:51:57 MDT 1994 Output from date 

You can also connect commands, using the output of one as input to another. 

See “Piping Command Output and Input”. 
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Entering Commands with the Key Shell 

The Key Shell (keysh) uses softkey menus and context-sensitive help to assist 
you with command options and syntax. The Key Shell automatically translates 
softkey commands into HP-UX commands when you press fEnter] to enter the 
command line. 

Using the Key Shell Displays 

The Key Shell gives you softkey displays at the bottom of your screen that 
provide a “menu” of basic shell commands, along with their options in sequence. 
To start Key Shell, enter the command /usr/bin/keysh. (Exit this shell by 
entering: exit.) You will first see a status line like the following 


$ I 

=== hpfcjdp === /users/jodi === You have mail === Wed^ Sep 1 , 1994 11:36:32 AM 
—Help—Mail Change List. Edit. Display Print —More— 

dir files file files files 1 of 4 

Key Shell Softkey Display 

You can enter commands from the Key Shell softkey menu or you can enter 
standard HP-UX commands as usual, if you enter standard HP-UX commands, 
the Key Shell will often display an appropriate left-to-right set of menu options 
in the softkc'y label area at the bottom of your screen. Each label corresponds 
to a softkey, f 1 through f8 . The hpterm at the center separates the softkeys 
into groups of four. You may select any or none of the options successively by 
pressing the corresponding softkey. 

When you want to see more commands, or more options to go with a command 
you have already chosen, press the —More— softkey, f 8 . This will cause the 
Key Shell to display the next “bank” of softkeys in sequence, eventually cycling 
back to the first, if you press f 8 repeatedly. 

After you make a selection by pressing a softkey, your choice will appear on the 
command line in “English,” just as it appeared in the softkey display, with the 
correct order and spacing. 
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Example: Entering a Command with the Key Shell 

For example, enter the Is command. You will see the following: 










bbbBhII!IB 

files 

inodes format. 

[i; symlinks 1 of 2 


Options Displayed 


Many softkey commands require that the user enter a parameter or select an 
additional softkey before pressing fEnter") . A “prompt line” underneath the 
command line will indicate whether you need to enter anything else. 

if you select Is, and then select the “sorted” option, the Key Shell will ask you 
to specify how you want your file listing sorted: 


$ Is SQr-tedJ 

Select. "alph.abet.ical"j "Qldest.-newest."j or "newest-oldest.". 
—Help—alpha- oldest- newest- 
betical newest oldest 


Required Options Requested 



At any time, you can use the —Help— softkey, f 1 , to find out more about 
what functions are available to you. 

Suppose you have selected “newest-oldest” for the sort option above. You can 
now enter the finished command line by pressing [Enter") . Or, if you want to 
preview the HP-UX commands to which these “English” words correspond, you 
can optionally press Qnsert line") and the HP-UX commands will be displayed as 
shown in the figure below. 




.. 






_1 


Optional HP-UX Commands Display 
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Customizing Your Key Shell Softkeys 

You can change the Key Shell’s configuration (for example, status line or 
options) using the Keysh_config softkey in the —More— 4 of 4 display. 
Any changes you make will be automatically saved in the . keyshrc file in your 
home directory. This file will then be replayed upon subsequent invocations of 
keysh. 

if they are not already on, some global options that you can change using 
Keysh_config are: 

To Enable Enter These Softkeys and Press fEnter") 

--Help-- softkey Keysh_config options help on 

Automatic prompt messages Keysh_conf ig options prompts on 

Visible HP-UX command Keysh_config options translations on 

translations 

To turn off any of these options, enlx'r off al, the end of the entry sequence 
instead of on. 


Status line indicators you can change, using the Keysh_conf ig softkey, are: 

To Enable Enter These Softkeys and Press fEnter") 

Hostname Keysh_config status_line host_name on 

Username Keysh_config status_line user_name on 


Current 

directory 


Keysh_config status.line current.dir on 


Mail status Keysh.config status.line mail.status on 


Date 


Keysh.config status.line date on 


Time 


Keysh.config status.line time on 


3-6 Using Your Shell 



Summary of Key Shell Procedures 

The general rules for using the Key Shell are: 

■ Select any desired softkeys from left to right. 

■ Use the —More— softkey to see more options. 

■ Optionally, iis(' lh(' [Insert line") key to preview the translated command-line. 

■ Use the —Help— softkey to find out more functions. 

if you make an error, use fBackspace") or fcTRL~] -fH] to erase the line back to where 
you want to re-enter command text. 

You can also use the arrow keys, [ clear lin^ , [ belete line] , [i nsert char] , and [ belete char] 
to manipulate your command line, in addition to using the editor that is set 
for your POSiX Shell (see “Editing the Command Line”). Note that fciear line") 
functions to delete the line only from the cursor position to the end of the line. 
fpeiete line") , however, deletes the entire command line and cancels the command. 

For more information, see the keysh{\) man page in the HP-UX Reference and 
the Shells: User’s Guide. 
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Understanding Processes 

The shell interprets your keyboard commands for the HP-UX operating system 
to act on. When you log in, you are said to be “in” a shell. After the shell 
interprets a command line, HP-UX loads into memory the corresponding 
program. When a program is running, it is called a process. HP-UX assigns 
every process a unique number, known as a process identifier (PID). 

How Processes are Created 

When you log in, HP-UX starts your shell. During login, HP-UX copies the 
shell program from system disk into memory. When it is in memory, the shell 
begins executing, and it becomes a process that lasts until you log out. Process, 
then, refers to the copied program that is actively executing in memory, while 
program is the file stored on the disk. 

Similarly, the commands you type create processes. After you type a command 
line, the following events take place: 

1. The shell interprets the command line and searches the disk until it finds the 
requested program. 

2. The shell asks HP-UX to run the program; then control transfers from the 
shell to HP-UX. 

3. HP-UX copies the specified program from a disk file into memory. When the 
program resides in memory, it begins executing—and a process is created. 

4. Each process is assigned a Process Identifier or PID. You can find out what 
processes are currently running on your system by typing ps -ef. 

5. When a program finishes executing, control transfers back to the shell, and 
the process disappears. 

Stopping a Process with kill 

Normally, processes can be terminated by entering the following, where PID is 
the identification number for the process you want to get rid of. 

kill PID 

The PID for the process is determined by running ps -ef and noting the name 
and process ID. 


3-8 Using Your Shell 



In some cases, the process may ignore the kill signal, and you will find it still 
running after you have issued the kill command correctly. If this happens, 
enter the following: 

kill -9 PID 

Run ps -ef to confirm that the process has been deleted. 
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Understanding Standard Inpnt, Standard Ontpnt, and 
Standard Error 

Each process opens three standard “flies”: standard input (stdin), standard 

output (stdout), and standard error (stderr). Programs use these as follows: 

■ Standard input is the place from which the program expects to read its 
input. By default, processes read stdin from the keyboard. 

■ Standard output is the place the program writes its output. By default, 
processes write stdout to the terminal screen. 

■ Standard error is the place the program writes its error messages. By 
default, processes write stderr to the terminal screen. 

The figure below illustrates the relationship of these flies to the process. 



Standard Input, Standard 
Output, and Standard Error 


Writing Standard Ontpnt to a File 

The shell lets you redirect the standard output of a process from the screen 
(the default) to a file. Redirecting output lets you store the text generated by a 
command into a file; it’s also a convenient way to select which flies or devices 
(such as printers) a program uses. 

in its simplest form, the command syntax is as follows: 

command > outfile 

where command is the command whose output is redirected, and outfile is the 
name of the file to which the process writes its standard output, if the output 
file exists, its previous contents are lost, if the file does not exist, it is created. 
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To append the output to an existing tile, use two greater-than signs (>>) pointing 
to the tile to be appended on. 

This figure illustrates where stdin, stdout, and stderr go when output is 
redirected to a file. 



Standard Input, Output, and Error When 
Output Is Redirected 


The example below shows output redirection using the who command, which 
displays a list of users currently logged in to the system. Instead of displaying 
the users on the terminal screen, the output is redirected to the file whoison. 


who > whoison 
more whoison 


pat 

console 

Oct 

9 

08:50 

terry 

ttyOl 

Oct 

9 

11:57 

kim 

tty02 

Oct 

9 

08:13 


Indirect output to whoison. 
Display contents 0 /whoison. 


Using Files for Standard Inpnt 

The shell lets you redirect the standard input of a process so that input is read 
from a file instead of from the keyboard. To redirect the input of a process, 
separate the command and the input file name with a less-than sign (<) directed 
at the command name. You can use input redirection with any command that 
accepts input from stdin (your keyboard). 

In its simplest form, the command syntax is as follows: 

command < injile 
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where command is the command whose input is redirected, and infile is the 
name of the tile from which the process reads standard input. The file must 
exist for the redirection to succeed. 

The figure below illustrates where stdin, stdout, and stderr go when input is 
redirected from a file. 



Standard Input, Output, and Error 
When Input Is Redirected 


In the following example, standard output from the who command is redirected 
to a file named savewho. Then, the more command displays the contents of 
savewho. Finally, standard input for the wc (mord count) command is redirected 
to come from the savewho file: 


who > savewho 
more savewho 


pat 

console 

Oct 

9 

08:50 

terry 

ttyOl 

Oct 

9 

11:57 

kirn 

tty02 

Oct 

9 

08:13 

wc -1 

< savewho 




4 


Redirect output to savewho 
Display contents ofs avewho 


Redirect inputfrom savewho 
The answer 


In the preceding example, the wc command with the -1 option counts the 
number of lines in the input file. Because input is redirected from savewho, 
this number equals the number of users logged in to the system when the who 
command was executed. 
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Redirecting Both Standard Inpnt and Standard Ontpnt 

You can redirect both the standard input and the standard output of a single 
command. However, do not use the same tile name for standard input and 
standard output, since the original contents of the input file are lost. 

The following figure illustrates where stdin, stdout, and stderr are directed 
when both output and input are redirected from and to files. 


oiitfile 

infile 


stdout 



stdin 





Redirecting Both Input and Output 
Using the Default Standard Input and Standard Output 


The following example uses the sort command to sort text typed at the 
keyboard. Typing [ctrl~) -[d1 ends standard input. The standard output displays 
on the terminal screen as follows: 


sort 

muffy 

happy 

bumpy 

fcTRL~] -fbl End of standard input. 

bumpy 

happy 

muffy End of standard output. 


Redirecting Standard Input 


In the following example, input is redirected: 

more socks Display contents of socks. 

polka dot 

argyle 

plaid 

sort < socks Redirect input from socks 
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and sort the contents. 


argyle 
plaid 
polka dot 

In the preceding example, the sort command uses a tile named socks as input. 
The standard output displays on the terminal screen. 

Using Both Standard Inpnt and Standard Ontpnt Redirection 

The next example combines both input and output redirection: 

sort < socks > sortsocks Use both input and output redirection. 

more sortsocks Display contents 

argyle 0 /sortsocks. 

plaid 

polka dot 

In this example, the sort command reads input from the socks file and writes 
output to the sortsocks file; thus, standard output (unlike the first two 
examples) does not display on your screen. 

Piping Command Ontpnt and Inpnt 

The shell lets you connect two or more processes so the standard output of one 
process is used as the standard input to another process. The connection that 
joins the processes is a pipe. To pipe the output of one process into another, you 
separate the commands with a vertical bar (|). The general syntax for a pipe is 
as follows: 

commandl I command^ 

where commandl is the command whose standard output is redirected or piped 
to another command, and command^ is the command whose standard input 
reads the previous command’s output. You can combine two or more commands 
into a single pipeline. Each successive command has its output piped as input 
into the next command on the command line: 

commandl I command^ I ... I commandN 

In the following example, output from the who command is again stored in the 
file savewho. Then, the savewho file is used as input to the wc command: 

who > savewho Indirect output o/who to file savewho. 
wc -1 < savewho File savewho is input to wc command. 

4 Sample result. 
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With a pipeline, these two commands become one: 

who I wc -1 
4 

As this example illustrates, using pipes eliminates the need for temporary 
intermediate flies. Instead, the standard output from the first command is sent 
directly to the second command as its standard input. 

Using the tee Command with Pipes 

The tee command lets you divert a copy of the data passing between commands 
to a file without changing how the pipeline functions. The example below uses 
the who command to determine who is on the system. In the example, which is 
further illustrated in the figure below, the output from who is piped into the tee 
command, which saves a copy of the output in the file savewho, and passes the 
unchanged output to the wc command: 

who I tee savewho | wc -1 
4 

more savewho 

pat console Oct 

terry ttyOl Oct 

kim tty02 Oct 


9 08:50 
9 11:57 
9 08:13 
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HP-UX provides filter programs that are useful in pipelines. These programs 
accept text as input, transform the text in some way, and produce text as 
output. Filter commands include adjust, awk, more, cut, grep, head, more, pr, 
rev, sed, sort, spell, and tail. For information on these commands, see their 
man pages in the HP-UX Reference (section 1). 
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Shell Features: Determining and Changing Your Shell 

HP-UX gives you your choice of several different shells. This section discusses 
the POSIX, Bourne, and Key Shells. Details on the C shell can be found in the 
Shells: User’s Guide. 

Each of these shells has different characteristics, and you can increase the speed 
and efficiency with which you interact with HP-UX if you learn to use some of 
the built-in features of the shell of your choice. 

With the POSIX and Key Shells, you can edit your command line and recall 
previous commands. Your shell environment can be “customized” using shell 
variables and login scripts. 

Using simple commands, you can determine which shell you are running or 
change your shell temporarily or permanently. See “Determining Your Login 
Shell” for a listing of both the file name for each shell and the default system 
prompt. 


Note As of the HP-UX 10.0 release, the OSF POSIX Shell replaces the 

Korn Shell and Bourne Shell. Thus, /usr/bin/sh will be the 
POSIX Shell, and /usr/bin/ksh will be linked to /usr/bin/sh. 
However, /usr/old/bin/sh will contain the Bourne Shell for 
those users who still need it. 


The following table lists features that may help you decide which shell to use: 
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Comparison of Shell Features 


Features 

Description 

POSIX 

Key 

Bourne 

C 

Command 

history 

Allows commands to be 
stored in a buffer, then 
modified and reused. 

Yes 

No 

Yes 

Line 

editing 

Ability to modify the 
current or previous 
command lines with a 
text editor. 

Yes 

No 

No 

File name 
completion 

Ability to automatically 
finish typing file names 
in command lines. 

Yes 

No 

Yes 

alias 

command 

Lets you rename 
commands, automatically 
include command 
options, or abbreviate 
long command lines. 

Yes 

No 

Yes 

Restricted 

shells 

A security feature 
providing a controlled 
environment with limited 
capabilities. 

Yes 

Yes 

No 

Job 

control 

Tools for tracking and 
accessing processes that 
run in the background. 

Yes 

No 

Yes 


Determining Your Login Shell 

The command echo $ SHELL displays the file name of the shell you entered when 
you logged in. 

echo $SHELL 
/usr/bin/sh 

The echo command displays the contents or value of a variable named SHELL. 
The SHELL variable contains the name of the file that contains the shell program 
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that you are running. In this example, it is /usr/bin/sh, the tile that contains 
the code for the POSIX Shell. 

The following table lists both the file name of each shell and the default system 
prompt. (The superuser prompt for each is #.) 


Shell File Names and Default Prompts 


Shell 

File Name 

Prompt 

POSIX 

/usr/bin/ sh 

$ 

Key 

/usr/bin/keysh 

$ 

C 

/usr/bin/csh 

1 

Bourne 

(obsolete) 

/usr/old/bin/sh 

$ 

Korn 

(replaced by 
POSIX shell) 

/usr/bin/ksh 
(linked to 
/usr/bin/sh) 

$ 


Temporarily Changing Yonr Shell 

Unless you are in a restricted shell, you can temporarily change your shell by 
using this command: 

shell^name 

where shell^name is the name of the shell (for example, sh, or csh). 

Temporarily changing your shell lets you experiment in other shells. By typing 
the name of the shell you want to run, you invoke (enter) that shell, and the 
correct prompt is displayed. To return to your original shell, type either exit or 

CcTR^-©- 

The following example begins in the POSIX Shell, enters the C Shell, and returns 
to the POSIX Shell: 


csh 

ps 

PID 

TTY 

TIME 

COMMAID 

Enter G Shell. 

Execute the ps command. 

6009 

ttyOl 

0:00 

csh 

Notice that both the C 

5784 

ttyOl 

0:00 

sh 

and POSIX Shell 

6010 

ttyOl 

0:00 

ps 

■processes are running. 
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"/, exit 
$ 


Exit G Shell. 

POSIX Shell returns. 


Permanently Changing Your Shell 

To permanently change your login shell (the default shell you get when you log 
in), use the chsh (change shell) command: 

chsh username fulPshelPname 

where username is your user name and shelLpath^name is the full path name 
(for example, /usr/bin/sh) of the shell you want as your default. “Determining 
Your Login Shell” contains the full path names for each of the shells. After you 
use the chsh command, you must log out and log in again for the change to take 
effect. For example, if terry changes the default login shell to the C Shell, the 
command reads: 

$ chsh terry /usr/bin/csh 

I 
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Editing the Command Line 

In the POSIX and Key Shells, you can correct errors in a command line before 
you enter it, using line editing commands or edit keys. You can also recall a 
previous command and edit it. See “Recalling Previous Commands” later in this 
chapter. 

Using vi Line Editing Commands 

Chapter 4 explains how to use the vi screen editor with text flies. The vi editor 
is also used to edit command lines. 

To enter the vi line editor mode while in the POSIX or Key Shells, press [esc] to 
change from the usual “typing mode” into “edit mode.” Use editing commands 
to move the cursor or delete characters. Return to “typing mode” by entering 
the vi commands i or a to insert or append text. In Key Shell, you can also use 
the arrow and editing keys on your terminal. 

The following table lists some vi editing commands. 


Desired action vi command 

Move back one character h 

Move forward one character 1 

Move back one word b 

Move forward one word w 

Move to the beginning of the line 
Move to the end of the line $ 

Delete the character under the cursor x 


The editor command set is governed by the setting of the EDITOR variable. 

Some possibilities are vi or emacs. Setting the EDITOR variable also depends on 
the VISUAL variable being defined. 

To use the vi editor temporarily, type set -o vi. To turn off the vi editing 
mode, type set +o vi. To set the EDITOR variable automatically each time you 
log in, see “Setting the Login Environment”. 
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An Example of Line Editing with the vi Command Set 

Activate the vi command set (if it is not already set at login by your login 
script): 

set -o vi 

Type this line without pressing fEnter"] : 

11 /dve I grep | more 

The second element should have been /dev. Correct the error by following 
these steps: 

1. Press fESc") . The cursor moves back one space (beneath the e in more). The 
line editor is now in “command mode.” 

11 /dve I grep ’~d’ | more 

2. Press @ repeatedly to move the cursor to beneath the v in /dve. 

11 /dve I grep ’~d’ | more 

3. Press Q. The character v disappears, and the rest of the line shifts one 
space to the left to fill in. The cursor is now under the e in /de. 

11 /de I grep ’~d’ | more 

4. Press The cursor moves one space to the right. The line editor is now 
ready to “append” text to the line. 

11 /de I grep ’~d’ | more 

5. Press ©• The character v is inserted after /de, completing the correction. 

11 /dev I grep ’~d’ | more 

6. Press fEnter") to execute the command line. 
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Recalling Previous Commands 

The POSIX and Key Shells store the commands you execute in a command 
history. You can retrieve these commands, modify them, and re-execute them. 
For information on the C Shell implementation of command history, see the 
Shells: User’s Guide. 

For example, make sure you are in the POSiX Shell by typing 
/usr/bin/sh 

Execute some commands, as a test. Then, to re-execute a previous command: 

1. Make sure you have set vi as the command line editor 

(enter set -o vi on the command line for the login session, or make the the 
appropriate entries in your .profile to set and export the EDITOR variable). 

2. Press (esc") . 

3. Then press ((kJ repeatedly to scroll back to the previous command that you 
want. 

4. Or, press (IJ to scroll forward through the command history list. 

5. Once you have found the command you want, you can edit it just as if it 
were the current command. 

6. You can then execute whatever is on the command line by pressing ("Enter") . 

The POSiX Shell “remembers” the last 128 command lines you typed in and can 
display all or any of them. For example, type in some commands: 

date 

Thu Sep 8 15:01:51 MDT 1994 
pwd 

/home/terry 

hostname 

hpabc 

Now type in this command: 

history -3 

121 date 

122 pwd 

123 hostname 

124 history -3 

Notice that the POSiX Shell displays the last three commands (date, pwd, and 
hostname) and the history -3 command. You can increase the amount of the 
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command history shown by using a larger negative number to follow history. 
For example, this will display the last 100 commands if there are 100 commands 
in the history: 

history -100 | more 

If there are fewer than 100 commands in the history, the full contents of the 
history will be displayed. The output of history is piped to the more command 
so you can see one screenful of the history commands at a time. 

The Key Shell will also display command history, with the added option of 
allowing you to use the terminal arrow and editing keys (instead of vi) to scroll 
through the command history and edit commands. As with the POSIX Shell, 
once you have displayed the command line you want, you can execute it by 

pressing fEnter") . 

For More Information ... 

For more details on the command history in the POSIX Shell, see the relevant 
tutorial in the Shells: User’s Guide. For more information on the Key Shell, see 
“Entering Commands with the Key Shell”. 

Briefer presentations are available in the sh-posix, keysh, and csh entries in the 
HP-UX Reference. 
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Setting the Login Environment 

When you log in, your shell automatically defines a unique working 
environment for you, which is maintained until you log out. Your environment 
defines such characteristics as who you are, where you are working, and what 
processes you are running. These characteristics are defined by values assigned 
to environment variables. 

Your shell environment is analogous to an office environment, in the office, 
physical characteristics like lighting and temperature are similar for everyone. 
But many factors in your office environment are unique to you, such as your 
routine tasks and your individual workspace. Thus, your work environment 
is different from that of your co-workers—just as your shell environment is 
different from theirs. 

The login Program 

When you log in, HP-UX runs a program named login. This program starts your 
session using data stored in the /etc/passwd file, which contains one line for 
each system user. This file includes your user name, password (in encrypted 
form), home directory, and the shell to run when you log in. if /etc/passwd 
doesn’t specify a shell, the POSiX Shell (/usr/bin/sh) is selected. 

The login program does the following: 

■ Display the Password: prompt (if you have a password). 

■ Verify your user name and password in the /etc/passwd file. 

■ Assign default or user-defined values to the shell environment. 

■ Start executing the shell process. 

Environment Variables 

The shell environment defines how HP-UX interacts with you. The 
environment’s characteristics are defined by environment variables, which 
consist of a name and a value. For example, the directory in which you begin 
each session is your home directory; its environment variable is the variable 
named HOME, and its value is assigned during the login process. Throughout this 
section, the value of HOME is equal to /home/terry. 

Here are some environment variables set during the login process. Note that 
most of these will already be set in your default .profile file. 
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HOME 

■ Defines the user’s home directory; the default directory for the cd command 
(for example, /home/terry). 

■ Default value assigned during login. 

LOGNAME 

■ Contains the user name (for example, terry). 

■ Default value is username 

MAIL 

■ Determines where the system looks for mail. Set based on the user name (for 
example, /var/mail/terry). 

■ Typical default value is /var/mail/r<.ser%ame 

PATH 

■ Sets the directories through which the system searches to find and execute 
commands. 

■ Typical default values include the following paths: 

/usr/bin:/usr/bin:/usr/contrib/bin:/usr/local/bin:/usr/lib 

SHELL 

■ Determines which shell to run. Set to the last field in the /etc/passwd file 
entry for the user logging in. If this field is not defined, the default value is 
used. 

■ Typical default value is /usr/bin/sh 

TERM 

■ Specifies the kind of terminal for which output is prepared. 

■ Typical default value is hp 

TZ 

■ Provides the current time zone and difference from Greenwich Mean Time. 
Set to Mountain Standard Time by default; your system administrator 
should change the value if you are in another time zone. Set by the script 
/etc/profile. 

■ Typical default value is MST7MDT 
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EDITOR 


■ Determines the default editor. 

■ Typical default value is vi 

DISPLAY 

■ Specifies window display host. Use on a remote system to display windows 
locally. 

■ Typical default value is DISPLAY=toca?:0 
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Using Login Scripts to Set the System Environment 

During the login process, HP-UX prompts you for your user name and password 
(if applicable) before displaying a shell prompt. HP-UX also notes which 
shell you have selected to run, starts your shell process, and sets up your 
environment referring to login scripts. A login script is a file that lets you 
customize your environment. 

A login script contains commands that let you define your system environment. 
When you log in, default values are assigned to environment variables. Login 
scripts provide an automatic way to change the value of these variables every 
time you begin a session. 

Two types of login scripts are used: 

■ A system script for all users of a particular shell on your system or HP-UX 
cluster. 

■ Local login scripts in your own home directory. 

Typically, a system administrator maintains the system login scripts. These 
scripts set up a default environment for everyone on that system. The POSIX 
and Bourne Shells use a system login script named /etc/profile. 

Once your account is set up, you maintain the local login scripts in your home 
directory. The local scripts allow you to set up an environment specific to your 
needs. The Bourne Shell looks for one script: .profile. The POSIX Shell uses 
two login scripts: .profile and the one referred to by the EIV variable. 

Default versions of the login scripts are placed in your home directory 
when your account is set up. Default versions are also in the /etc 
directory. For reference, the default .profile script for the POSIX Shell is 
/etc/skel/.profile. 


Why Use Login Scripts? 

Login scripts provide a convenient way to set up the shell environment to suit 
individual needs. For example, the script can change the value of the search 
path used to find commands, change the shell prompt, set the terminal type, or 
simply cause the shell to greet you with a friendly message of your choosing. 

Customizing your login script is not required, and the login script your system 
administrator provides should set up the most critical shell parameters. 
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A Summary of Login Scripts 

The following table summarizes the login scripts for each shell. All the scripts 
run when you first log in. For more information on the POSIX, C, Key, and 
Bourne Shells, see the Shells: User's Guide. 


Shells and Their Login Scripts 


Shell 

System 

Login Script 

Local 

Login Script 

POSIX 

/etc/profile 

$H0ME/.profile 

c 

/etc/csh.login 

$HOME/.cshrc 
$H0ME/.login 

Key 

/etc/profile 

$H0ME/.profile 
$H0ME/.keyshrc 
$H0ME/.softkeys 

Bourne 

(obsolete) 

/etc/profile 

$H0ME/.profile 
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Setting and Referencing Variables 

Your shell uses both environment variables and shell variables to define your 
environment. Your login shell uses environment variables and passes them to 
all processes and subshells that you create. Shell variables are known only to 
your current shell and are not passed to subshells. 

The POSIX and Bourne Shells set variables using an assignment statement and 
an optional export command. In all shells, you refer to the value of a variable 
by placing a dollar sign ($) in front of the variable name. 


Assigning Valnes to Variables 

In the POSIX, Bourne, and Key Shells, variables are assigned (or set). They can 
also be created, if necessary. Both tasks are done with an assignment statement: 

name=value 


The name is the variable name and value is the value assigned to the variable. 
No spaces are allowed between name and = or between = and value. 

In the following example, which works with POSIX or Bourne Shells, the shell 
prompt (PSl) is reset so that it reads: 


Ready ==> 

If PSl is a shell variable, the subshell (created by typing sh) does not know the 
new value. If you export PSl, the value of PSl passes to the subshell: 


PSl="Ready ==> " 
Ready ==> sh 
exit 


Ready ==> export PSl 
Ready ==> sh 
Ready ==> 


Set shell variable PSl. 

Type in subshell name. 

Subshell now has default prompt; exit returns to 
original shell. 

Set environment variable with export. 

Enter subshell. 

Subshell knows the new value o/PSl. 
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Referencing the Valnes of Variables (Parameter Snbstitntion) 

All three shells use parameter substitution for referencing the value of 
variables. Parameter substitution means that the variable’s value is substituted 
for the variable name. Parameter substitution occurs when a dollar sign ($) is 
placed in front of the variable name. 

For example, earlier you learned to determine your login shell with the 
command echo $ SHELL: 


echo SHELL 
SHELL 

echo $SHELL 
/usr/bin/sh 


Because $ is omitted, the word 
SHELL is echoed. 

The $ is included, so the value 
of SHELL is echoed. 


The echo $SHELL command uses parameter substitution. The shell substitutes 
the value of the environment variable named SHELL into the echo command 
because the dollar sign ($) precedes the variable name. 


For More Information ... 

To learn more about parameter substitution, refer to sh, sh-posix, keysh, or csh 
in the HP-UX Reference (section 1) or to the Shells: User’s Guide. 
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Finding Commands with Search Paths 

When you type a command, HP-UX must be able to find the directory containing 
the command before it can run the command. The PATH environment variable 
contains a list of directories you want HP-UX to search when looking for 
commands. Your PATH should contain all the directories necessary to locate all 
the commands that you use. 

PATH Variable Format 

The PATH variable is read from your .profile or /etc/profile login script, 
it contains a list of directories to search, separated by colons. There should 
be no spaces surrounding the colons. You can also use the echo command to 
determine the current value of PATH, as follows: 

echo $PATH 

/usr/bin/sh:/usr/bin:/usr/local/bin 

This line means that when you type a command, the shell first searches for the 
command in the /usr/bin/sh directory, in the /usr/bin directory, and then in 
the /usr/local/bin directory, if the command is not found in any of these 
directories, the shell displays this message: 

command_name: Command not found. 


Changing PATH 

if the shell can’t find a command that you know exists, you have two options: 

1. Type the full path name of the command. For example, if you wish 
to execute a command called prog, and it resides in the directory 
/home/leslie/bin, type this: 

/home/leslie/bin/prog 

2. Or, change the value of the PATH variable to add the command path, a better 
long-term solution if you use the command frequently. 

The following table shows the path names of the most frequently used 

directories. 

Directory What It Contains 

/usr/bin Frequently used HP-UX commands. 

/usr/sbin Commands the system administrator uses. 
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/usr/bin/sh 
/usr/contrib/bin 
/usr/local/bin 
$H0ME/bin 


POSIX Shell 

Contributed programs not supported by Hewlett-Packard. 

Programs and commands written at your location. 

A directory you might create for your own shell scripts and 
programs. 


Caution Because of the potential security risk, do not put your current 
directory (usually represented as .) as the first element in 
PATH. Leave the current directory out of your PATH, or include 
it only as the last element. 


Remember that directories in PATH are searched in the order in which they 
appear (left to right). In general, put the most frequently used directories first 
in the path—unless two commands in the search path have the same name (for 
example, /usr/bin/rm and $HOME/bin/rm). In this example, if you want the 
shell to find your version of rm first, put $H0ME/bin before /usr/bin in PATH. 

The following example shows how to alter PATH to include $H0ME/bin before 
any other directories, and to include the current directory as the last directory 
in the search path (this example assumes you’re using the POSIX, Bourne, or 
Key Shell): 

echo $PATH 

/usr/bin/sh:/usr/bin:/usr/bin: 

/usr/contrib/bin:/usr/local/bin 
PATH=$HOME/bin:$PATH:. 


echo $PATH 

/home/terry/bin:/usr/bin/sh:/usr/bin: 
/usr/bin:/usr/contrib/bin:/usr/local/bin 


Including . as the 
last element makes 
the current direc¬ 
tory the last one searched. 


Setting PATH as an Environment Variable 

Normally, you set PATH as a environment variable, so it is set to the appropriate 
value when you log in. In the Bourne and POSIX Shells, you can change PATH in 
the .profile script and export it. You can find out more about these scripts in 
Shells: User’s Guide. 
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Setting Terminal Characteristics 

For most effective use of your terminal, HP-UX must know the type of terminal 
or graphics display you’re using. If no terminal type is provided, the default 
value is TERM=hp. The tset command sets terminal characteristics. 

The default local login script prompts you to enter your terminal type as 
follows: 

TERM = (hp) 

Pressing fEnter") sets the TERM environment variable to hp, the default value. This 
value works with Hewlett-Packard terminals, but it may not let you take full 
advantage of your terminal or graphics display features. Entering a different 
value sets the TERM environment variable to that value. 

Selecting a Value for the TERM Variable 

HP-UX supports many terminal types. The /usr/share/lib/terminfo database 
tells HP-UX how to communicate with each terminal type. When you assign a 
value to TERM, the value must equal a value in the terminf o database. 

For example, the files listed under /usr/share/lib/terminfo/2 show all 
acceptable TERM values that begin with 2 (this is only a partial listing): 


Is /usr/share/lib/terminfo/2 


2382 

2397a 

2621a 

2623p 

2626-X40 

2640a 

2392 

2500 

2621k45 

2624 

2626A 

2640b 

2392A 

2621 

2621nl 

2624a 

2626P 

2644 

2392a 

2621-48 

262Int 

2624p 

2626a 

2645 

2393 

2621-ba 

2621p 

2625 

2626p 

2647 

2393A 

2621-fl 

2621wl 

2626 

2627 

2647F 


Here are the most common terminal and graphics display settings for 
Hewlett-Packard equipment. When more than one choice is listed, all choices 
are equivalent. 

If You Are Using a .. Set TERM to .. 

terminal the terminal’s model number; for example 2622, 

hp2622, 262x, or 2392 

Vectra 2392 
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medium resolution graphics 3001 or hp3001 
display (512x600 pixels) 


high resolution graphics 300h or hp300h 

display (1024x768 pixels) 


HP 98550 display station 98550, hp98550, 98550a, or hp98550a 

(1280x1024 pixels) 

HP 98720 or HP 98721 display 98720, hp98720, 98720a, hp98720a, 98721, 
station (1280x1024 pixels) hp98721, 98721a, orhp98721a 


Setting TERM with the tset Command 

The tset command (with the -s option) sets the value of TERM and initializes 
your terminal characteristics. If you always log in using the same terminal type, 
you may change your .profile to eliminate the TERM prompt. Your .profile 
contains a line similar to: 

eval ‘ tset -s -Q -m ’:?hp’ ‘ 

This command displays the TERM prompt. To customize the command, replace 
?hp with your terminal type. 

For example, the following command initializes your terminal as a 
high-resolution graphics display (300h), but the TERM prompt itself does not 
display: 

eval ‘ tset -s -Q -m ’:300h’ ‘ 

If you use more than one type of terminal (such as one at work and one at 
home), you can modify your tset command to include multiple terminal types. 
See tset{\) in the HP-UX Reference for more information. 
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Chapter Command Summary 

To Do This . .. Type This ... 

Delete (remove) a file interactively rm - i filename 
Run several commands on same line command;command^ 
Temporarily change to Key Shell /usr/bin/keysh 
Show additional Key Shell choices —More— 


Change Key Shell configuration 

Find command information online 
See what processes are running 
Stop a process 

Stop an unresponsive process 

Redirect standard output to a file 

Append standard output on a file 

Redirect input from a file to a 
command 


Keysh_config 
man command^name 
ps -ef 
kill PID 
kill -9 PID 
command > outfile 
command » outfile 
command < infile 


Redirect both standard input and command < infile > outfile 
output to a file 

Connect (“pipe” between) two commandl I command2 

processes 

Save command output to a file and commandl I tee file I command2 
send to another command 

Determine what shell you are in echo $SHELL 
Temporarily change to POSiX Shell /usr/bin/sh 
Temporarily change to C Shell /usr/bin/csh 

Permanently change to another shell chsh username shelPpath^name (then log 

out and log in again) 

Set command-line editor set -o editor_name 


Edit your command line (once editor Press fESc) ; use vi commands to move 
is set) cursor and enter text 
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Recall a previous command line 


Execute a previous command line 


Set a variable value 


in vi mode, press fESc ) ; press k 
(backwards) or j (forward) to move 
through command history tile 

Press ( Enter] when desired command line is 
displayed 

VARIABLE_NAME= variable ^value 


Display PATH setting echo $PATH 

Set terminal parameters tset options terniAype 
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Using the vi Editor 


The vi (Wsual) editor is the default text editor for your HP-UX system, vi is a 
powerful, versatile editing tool. 


Using the vi Editor 
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Starting the vi Editor 

Start vi by entering the following command at the prompt: 
vi filename 

If a file called filename exists, you will see the first screen of that file. If the file 
does not exist, it is created, and you will see a blank screen. 


Note If you do not wish to use vi, you can use the optional Emacs 

editor. Emacs is a widely used public domain editor that 
provides many versatile functions. 

GNU Emacs, and other related software, is available from: 

Free Software Foundation, Inc. 

675 Massachusetts Avenue 
Cambridge, MA 02139-3309 
USA 

+1-617-876-3296 
gnuOprep.ai.mit.edu 

You can also get information on Emacs from GNU Emacs: UNEC 
Teoct Editing and Programming, Addison-Wesley, 1992. 


Command Mode and Text Entry Mode in vi 

The vi “Visual Interactive” editor has two basic modes for manipulating text: 

■ Command mode 

■ Text entry mode 

When you enter vi, you will be in command mode until you enter one of the 
text entry codes, such as i or a, which are explained in this section. 

In text entry mode, you can backspace and type over text you have just entered 
(by pressing fcTRL] -fiT) or fBackspace"] ). But, if you want to move around otherwise 
in your text and execute other text manipulation commands, you will have to 
press fESc] to return to command mode. 
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If You Make Mistakes 

Use the following procedures to correct mistakes: 

■ if you type an error while entering text, press (Backspace) to back up over the 
error, and then re-type the correct text. 

■ The u undo command (lowercase u) reverses the last change made to your 
text. The U undo command (uppercase U) reverses all the changes made to a 
single line since you began editing that line. 

■ if you type several errors and cannot recover, exit vi without saving the tile, 
and start over. To do this, press (esc") . Then type q! fEnter") . 


Caution While you work in a file, save your changes frequently (every 
5 to 10 minutes). Regular saving helps you avoid losing your 
changes if there is a power failure or other accident. See 
“Saving Your Work and Exiting vi”. 
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Entering and Deleting Text 

Press fESc] to ensure that vi is in command mode. Then you can execute any 
of the following commands (among others). The text entry commands put vi in 
text mode; the deletion commands do not. 


Type This ... 

i 


I 

a 


A 


To Enter Text ... 

Preceding the cursor. Everything after cursor moves to the 
right. 

Before the first character of the line. 

After the current cursor position. Cursor moves to the right, 
and text is inserted as with i. 

At the end of the line. 


o 

0 

Type This ... 

X 


Open a blank line below cursor for text entry (lowercase o). 
Open a blank line above cursor for text entry (uppercase 0). 

To Delete ... 

Character highlighted by the cursor. Does not put document in 
text mode. 


%x n characters, starting at the cursor. 

dw From cursor to beginning of next word or first punctuation. 


dd 


Deletes current line. 


dG All lines to end of file, including current line. 

When you enter commands in vi, letter case (caps or small letters) does matter. 
For example, lowercase i and uppercase I represent two different commands. 
Therefore, if the cursor doesn’t move as it should, make sure the fcaps") key is 
not locked on, or see your system administrator. 
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Positioning the Cnrsor 


These keys move the cursor as follows (press ( esc] first for command mode): 
To Do This ... Type This . .. 

Move the cursor right. 1 or 

Move the cursor left. h or 0 

Move the cursor up. k or Q 

Move the cursor down. j or Q 


To move to a specific line, use G, a “goto” command. For example, suppose you 
are editing a file and want to go to line 799. You type 799G, and the cursor 
moves to line 799. Similarly, to go to line 1 of the file, type IG. To move the 
cursor to the last line, simply type G. 

To find the current line number, press (ctrl") -!^; to display line numbers along 
the left margin of your file, type :set number. 
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Scrolling through Text 


To scroll, press fESc] to ensure that you’re in command mode, then type the 
appropriate key while holding down the fcTRi") key. 


To Scroll ... 

Backward to previous screen. 
Backward one half screen. 
Backward one line. 

Forward to next screen. 
Forward one half screen. 
Forward one line. 


Type This 

fcrni -CBi 

fcmi -rai 

Ccrni -fYi 

fcmi -rn 

rcrni -fpl 

[ct^-CD 


4-6 Using the vi Editor 



Finding Text Patterns 

To search forward from the current cursor position, use this command: 

/pattern [| nter] 

where pattern represents the specific sequence of characters you want to search 
for. 

To search backward from the current cursor position, use this command: 

^pattern [Enter") 

When you press [Enter] , vi searches for the specified pattern and positions the 
cursor at the first character in the pattern sequence. For example, to search 
forward for the word place, type: 

/place ["Enter") 

If vi finds place, it positions the cursor at the p. To search for additional 
occurrences of place, press either Q or ®: 

■ Q continues searching in the same direction for place. 

■ @ reverses the direction of the pattern search. 

If vi does not find the pattern you specified, it displays the following message at 
the bottom of your screen, and the cursor is not moved: 

Pattern not found 


Searching for Special Occurrences 

In the previous example, vi finds any sequence containing the pattern place, 

including displace, placement, and replaced. 

■ To find the single word place, type the pattern with a space before and after 
it (the u represents a space): 

/UplaceU ["Enter") 

■ To find place occurring only at the beginning of a line, precede the pattern 
with a caret (~): 

/"place ["Enter") 

■ To find place occurring only at the end of a line, follow the pattern with a 
dollar sign ($): 

/place$ [Enter") 
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To search literally for such a character as a caret (~) or a dollar sign ($), precede 
the character with a backward slash (\). The backward slash tells vi to search 
for a special character. 

Special characters are those (such as ~ , and . ) that have special 

functions for vi. For example, a $ normally means “go to the end of the line,” 
but if the $ is preceded immediately by a \, the $ is simply another ordinary 
character. 

For example, / (lo \$ money) searches forward for the pattern (lo $ money). 
The escape character (\) immediately preceding the $ tells vi to search literally 
for a dollar sign. 
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Replacing Characters 

To replace a single character of text, press ( esc") to enter command mode, 
position the cursor over the character you want to replace, and type r while in 
command mode. Then type the replacement character. The r command lets you 
substitute only one character. After you have replaced the character, you are 
back in command mode. 
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Substituting Characters 

To substitute one or more characters for a single character, type s while in 
command mode. Unlike the r command, the s command puts you in insert 
mode and lets you substitute more than one character for a single character. 

When you type the s command, a dollar sign ($) appears in place of the 
character. After you type the desired character (or characters), press fESc") . 

To substitute for more than one original character, precede the s command by 
the number of characters. 
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Saving Your Work and Exiting vi 

You can save your work with or without quitting vi. Press ( esc] to ensure that 
vi is in command mode. 

To Do This ... Type This .. . 

Save without quitting vi :w 

Save and quit vi :wq 

Quit vi without saving changes : q! 

Save under another tile name : w filename 

Save in an existing tile and overwrite : w! filename 
that tile 

To print your flies, see “Viewing and Printing Files” in Chapter 2. 
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Using Options to Change Yonr vi Environment 

To customize vi, you can set (or unset) any of several options. When you enter 
vi, options are assigned certain default values. 

When exiting vi, all options return to the default, so you will need to reset your 
options each time you enter vi. See the next section for how to make your 
options permanent. 

To see all your default options, type: 

:S0t all ( Enter) 

To change these values, use the :set command: 

:set option fEnter") 

where option is the name of the editor option you want to use (see the 
following table for descriptions of some of these options). 

To unset (discontinue) an editor option, type no before the option: 

:set nooption fEnter] 
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Editor Options 


Option 

Abbrev. 

Default 

Effect When Set 

all 

' 

' 

Lists all editor options on the screen. 

autoindent 

ai 

noai 

Begins each new line of text in the same 
column as the previous line (useful for 
programmers). 

ignorecase 

ic 

noic 

Causes vi to ignore uppercase and 
lowercase during searches. 

number 

nu 

nonu 

Numbers each line of text. 

readonly 


noreadonly 

Enables write protection on the file you 
are editing. This ensures that you don’t 
accidentally change or destroy the file’s 
contents. 

shownatch 

sm 

nosm 

Shows the opening parenthesis, brace, or 
bracket when you type the corresponding 
closing parenthesis, brace, or bracket. This 
option is useful when you are typing 
mathematical expressions or writing 
programs in a language that uses 
parentheses, braces, or brackets. 

showmode 


noshowmode 

Displays a message like “IIPUT MODE” or 
“REPLACE MODE” at the bottom of the 
screen whenever you are in either of these 
modes. 

wrapmargin 

wm 

wm=0 (zero) 

Changes the right margin, n equals the 
number of spaces in the right margin. For 
example, if you’re using an 80-column 
terminal, then :set wm=8 sets the right 
margin at column 72. 
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Making Your vi Environment Permanent 

To avoid setting options or defining abbreviations or macros each time you enter 
vi, place all options and definitions you normally use into an . exrc file in your 
home directory. This file is read automatically each time you enter vi and its 
contents make your customized vi environment permanent. 

To create or change the . exrc file, follow these steps: 

1. Type cd at the HP-UX prompt to ensure that you’re in your home directory; 
then use vi to create or edit the . exrc file: 

cd 

vi .exrc 

2. Type the options, word abbreviations, and macros you want to make 
permanent (don’t precede the commands with a colon). 

3. Type :wq to save the text and exit vi. 

After creating the . exrc file, you can access it whenever you want to change 
your vi environment. Any of the editor options discussed in the previous 
section can be placed in this file. 

An Example of Changing Yonr .exrc File 

In “Using Options to Change Your vi Environment”, you saw examples of some 
of the options that change the overall behavior of vi. You can also make vi 
recognize short forms of commonly used expressions by using ab to define an 
abbreviation. 

If you include the following options and abbreviations in your . exrc file: 


set wm=8 

set showmode 

ab eeg Electrical Engineering 


«._ 

_ J 


Then you have changed your vi environment so that each time you enter vi, 
you can expect the following: 
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■ The right margin automatically contains eight spaces (changing the default 
from zero), and a carriage return will occur after approximately 72 spaces. 

■ The lower right part of the screen will show “INPUT MODE” when you are in 
any of the text insert modes. 

■ Whenever you enter eeg, this abbreviation will automatically expand into the 
words Electrical Engineering. 

For more information on this versatile editor, see The Ultimate Guide to the vi 

and ex Teoct Editors. 
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Chapter Command Summary 


To Do This . .. 

Enter vi and create or use existing Jrte. 

Insert text before the cursor. 

Append text after the cursor. 

Delete one character. 

Return to command mode. 

Move the cursor right. 

Move the cursor left. 

Move the cursor up. 

Move the cursor down. 

Exit vi without saving changes. 

Write (save) the current file. 

Write the current file and quit (exit) vi. 

Write the current file to filename 

Overwrite contents of filename with the current 
file. 

Write lines x through y of current file to 
filename. 

Insert contents of filename into the current file. 

Run an HP-UX command while in vi 

Print the current file (see “Viewing and Printing 
Files” in Chapter 2) 


Type This ... 

vi file f Enter ] 

i 

a 

X 

CHS 

1 or 0 
h or 0 
k or Q 
j or 0 
:q! f Enter] 

:w 

:wq 

: w filename 
:w! filename 

:x,ya filename 

(x, y are specific line numbers 

or place markers) 

: r filename 

: ! command 

: ! Ip •/. 
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Using Electronic Mail 


With an electronic mailer program, you can send and receive messages over 
a network. You can communicate quickly anywhere within your company, 
country, or the world. 

If you are on a multi-user system, you can send mail messages to other users on 
your system. If your system is configured to a network, such as a local area 
network (LAN), you can send mail messages to users on other systems. 

If you are connected to a larger network such as the Internet, you can 
communicate with users worldwide. Consult your system administrator to 
determine where you can send electronic mail. 
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Starting the elm Mailer 

The HP-UX mailer program is called elm (the etectronic mailer). Other mailers, 
such as mailx, are also available. See the Mail Systems: User’s Guide. 

1. To start the elm mailer, type elm at the system prompt. 

2. If this is the first time you have started elm, you will be asked two questions 
about creating directories and folders. Answer y (yes) to both. 

3. To get help in elm, press 0 at the command prompt. 

a. For a summary of all of the commands you can use from elm, press 0 
again. 

b. For help on a particular command, type the first letter of the command 
(for example, press 0 to get information about the reply command). 
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Understanding the Main Screen 

The main screen of elm has several components, shown in the following 
illustration. 


Message Number of lines 

Heading Date sender in message Subject of message 


Current 

message 

pointer 

Status 

field 

Message 

number 


Menu 


Command 
prompt 

The elm mailer lets you send and receive messages. 

The main screen has these elements: 

Heading The first line on the screen displays the current mailbox, the 

number of messages, and the current elm revision number. 

Date The date when the message was sent. 

Message sender The mail address of the person who sent the message. 

Number of lines The total number of lines in the message. 

Subject of message A description of the contents of the message. 

Current message The highlight indicates the current message, 
pointer 
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Status field 

Message number 
Menu 

Command prompt 


The status or characteristics of each message. The field 
can be blank, or contain the following common status 
characters: 

I—new message 

lU—new urgent message 

D—message is to be deleted 

This is used to specify a message. 

This three-line menu at the bottom of the screen shows the 
commands available. 

In response to the “Command:” prompt, type any of the 
commands in the menu. 
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Entering elm Commands 

Even if you are not familiar with mailers, you can easily use elm by following 
the instructions displayed on each screen. 

To enter an elm command, type the first letter (uppercase or lowercase) of the 
command. Commands in elm are not case-sensitive. 

For a summary of elm commands, press 0 within elm, then press 0 again. 
Also see “Chapter Command Summary” at the end of this chapter. 
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Reading Your Mail 

To read your mail, start elm by typing elm at the command prompt. 

If you have mail, elm displays a list of mail messages. You can read the current 
message or pick a specific message to read. Messages appear in a display similar 
to the following: 


Hailbox is V^r/mail/leslie’ with 4 message(s) [Elm reyision 7B.B5] 


H 2 Mar 11 James Keath (40) Congratulations! 

M 3 Mar 11 Anne Rand (159) Results of Meeting 

M 4 Mar 11 trayis_ha11^07 (91) Management Guide 


Elm lists your mail messages. 

■ To read the current (highlighted) message, press fEnter") . 

(You can configure elm to use a > to indicate the current message. See 
“Customizing elm”.) 

■ To advance to the next message, press Q. 

■ To move to the previous one, press 

■ To jump to a specific message in the header, type the number of the message 
and press (Enter") . 


Caution Problems with system behavior may result if you attempt to use 
one of the other HP-UX mailers, such asmailx, while you are 
also working in elm. 


This example shows the output from reading message 1. 
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An example message. 


To return to the elm main screen, press ( Enter) . 

Only ten message headers appear on the screen at one time. If you have more 
than ten messages you can display them as follows: 

■ To see the next page of message headers, press ©• 

■ To see the previous page, press Q. 

■ To move to the first message in the list, press [0. 

■ To move to the last message in the list, press Q. 
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Sending Mail to Users on Yonr System 

One of the easiest ways to learn how to send a mail message is to send one to 
yourself. 

1. Start elm by typing elm at the command prompt. 

2. To mail a message, press @ as the response to “Command:” 

Command: m 

3. elm responds with a prompt requesting the mail address of the recipient. 

(To use aliases for recipients, see “Using Mail Aliases”.) 

On your local system, your mail address is the same as your user name. 

Type your user name and press fEnter") . For example: 

Send the message to: leslie 

To send a message to more than one person, simply specify each recipient’s 
name. 

Send the message to: mike leslie tj 

4. elm then responds with a subject line prompt. Type the subject line of the 
message and press fEnter") . For example: 

Subject of Message: Important Message to Myself 

5. elm responds with a prompt for the carbon copies. Type the mail addresses 
of any users who should receive a carbon copy of the message, then press 
f Ent^ . 

In this example, since you’re sending a message to yourself, you don’t want 
to send any additional copies so press fEnter") . 

6. elm brings up a vi editor window. Type the message. For information about 
using the vi editor, see Chapter 4. 

This screen shows a sample message. 


This is a mail 

message sent to myself. 

Does it work? 

We’11 soon see. 

Goodbye, 


Leslie 



An example message. 
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To configure your workstation to bring up a different editor, see “Customizing 
eim”. 


7. When you are done typing, save the message. 

8. After you exit the editor, you wiii see the foiiowing message on the screen. 

Please choose one of the following options by the first character: 

E)dit message, edit the H)eaders, S)end it, or F)orget it. s 

9. To change any of the header information for your message (for exampie, 
to add recipients to the Cc iist, change the message subject, or mark the 
message as Urgent), press 

10. To send your message, type s 

11. After you have sent the mail message, the elm main screen reappears and 
displays the message “Mail sent! ”. It might take a few seconds for the 
system to deliver the message. 
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Sending Mail to Users on Other Systems 

If your system is connected to other systems over a LAN (local area network) or 
other networking facility that supports elm, you can also send mail to users on 
other systems. 

Host Names 

Every workstation connected over a network has a unique host name (also 
known as a node name). To send mail to a user on another workstation, you 
must know the host name of the user’s workstation. 

This figure shows an example LAN with four workstations connected. The host 
names are research, market, develop, and sell. 


research market 


' 


s. 

Series 800/877 


Series 700/715 

k_ 


k_k 


Series 700/730 


s. 

Series 700/735 

k_ 


k_k 


develop sell 


Example host names on a network. 

To determine your system’s host name, use the hostname command. 



CreateAction DigitalClock 

The host name is circled. 
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Mail Syntax when Mailing to Other Systems 

The general syntax used when mailing to a user on another workstation is 
either: 

user@host simple format 

user@host.organization, domain Domain naming 

host is the host name of the workstation the person is on, and user is the 
person’s unique user name. 

if the user you are sending to is at another organization, the syntax may also 
include that person’s organization name (such as ucsd or hp), and the domain 
to which the organization belongs (such as edu for educational institutions, and 
com for commercial businesses). 

Your system administrator can tell you which syntax to use. 

Examples 

Suppose you want to send mail to user John, who uses the workstation named 
sell. Then, in response to the elm prompt, you would type the following: 

johnOsell 

To send mail to arnie on your workstation, John on the sell workstation, and 
leopold on the research workstation, use the following addresses: 

arnie johnOsell leopoldOresearch 

To send mail to mark who works for a university and davidm who works for the 
XYZ company, use the following addresses: 

mark0hub.ucsd.edu davidm0xyz.com 

in the first part of this example, mark is the user name, hub is the hostname of 
Mark’s workstation, ucsd is the abbreviation for “University of California at San 
Diego”, and edu is the domain name for educational institutions, in the second 
part, davidm is the user name, xyz is the abbreviation for the XYZ Company, 
and com is the domain name for companies and businesses. 
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Using Mail Aliases 

You can set mail aliases for people you mail to frequently. Aliases are shortcuts 
that you define so you don’t have to type a recipient’s complete mail address. 

elm provides two types of aliases: 

User alias For private use. Individual users create and maintain their own 
user aliases. To create user aliases, see “Creating Mail Aliases”. 
System alias For use by all users with the same host. The system 

administrator must create and maintain the system aliases. 

Understanding Mail Aliases 

Aliases allow you to send messages to several recipients by specifying a single 
name, or to send messages without specifying a complete mail address. 

For example, for Christine Lawson at mail address ChristineOmarket. elm.com 
you might create the alias chris. To send a message to Christine, you could 
enter her alias at the To: prompt: 

To: chris 

elm automatically converts it to the proper address and full name: 

To: christine@market.elm.com (Christine Lawson) 

Here are more example aliases. (These aliases are shown in the format that elm 
uses to store them in the /HomeDirectory/ . elm/aliases . text file. This file is 
automatically appended to when you create aliases.) 

writers = My writing group = John jtl michele ken willa bg 
friends = David and Mark = davidm@xyz.com mark@hub.ucsd.edu 
tom = Tom Middleton = tmm@eff.org 

Thus, sending a message to writers means that John, jtl, michele, ken, 
willa, and bg on the local system all receive the message. Sending a message 
to friends means that davidmOxyz. com and markOhub. ucsd. edu receive the 
message. Sending a message to tom is shorthand for sending to tmmOeff .org. 
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Creating Mail Aliases 

1. Press 0 in response to the “Command:” prompt on the elm screen. The 
“Alias commands” sub-menu appears. 

2. Press [mJ at the “Alias:” prompt to make a new alias. 


Note To make an alias for the person who sent the current message, 

use a instead of m. This command reads in the sender’s address 
automatically in step 5. 


3. Enter the desired alias name, and press fEnter") . For example: 

Enter alias name: chris f Enter] 

You can set more than one alias name. For example, if you enter chris and 
cl in the example under “Understanding Mail Aliases”, you can use either 
alias to send mail to Christine Lawson. 

4. Enter the full name at the next prompt, and press fEnter") . 

For example: 

Full name for chris: Christine Lawson f Enter") 

5. Enter the address in response to the next prompt, and press fEnter") . 

For example: 

Enter address for chris: christine@market.elm.com f Enter") 

Then the sub-menu “Alias commands” returns. 

6. Press fEnter") to Set the alias. The main screen returns. 

Note To create an alias for a group of users, enter more than one 

address. For example, if you set: 

In step 3 Enter alias name: friends 
In step 4 Full name for friends : Incredible Three 
In step 5 Enter address for friends: chris, John, 
alex@market 

You can send a message to chris, John, and alex by 
responding to the “To:” prompt with: 

To: friends fEnter") 
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Note that you must make the aliases chris and John before 
making the group alias, if aliases have not been made, you must 
enter the user’s full address, as is done with alexOmarket. 


Listing and Deleting Aliases 

You can view your aliases and delete those you no longer need. 

1. Press @ in response to the “Command:” prompt on the elm screen. The 
“Alias commands” sub-menu appears. 

2. To check the address of a specific alias, press Q and enter the alias name. 

3. To list user aliases, press 

4. To list system aliases, press [0. 

5. To delete a specific alias, press [0 and enter the alias name. 

6. To return to elm’s main screen, press or press fEnter") . 
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Replying to Messages 

When you receive a message, you may want to reply to it right away. 

1. Move the message pointer to highlight the message to which you want to 
reply. 

2. To reply to just the sender of the message, press ®. 

Or, to reply to everyone who received the message, press (]^. 

The following message appears at the bottom of the screen. 

Command: Reply to message Copy message (y/n)? n 

(If you pressed “Group reply” appears after “Command:”.) 

3. Press (Enter") If you don’t need to include the original message in your reply. 
Press (yJ if you do need to include it. 

4. The bottom part of the screen now appears similar to this: 

Command: Reply to message To: Charlie (Charlie Pike) 

Subject of message: Re: Meeting Schedule Changed! 

The “To:” and “Subject of message:” fields are automatically filled in. The 
“Re:” in front of the subject indicates that the message is a reply. 

If the message you are replying to has no subject, 

“Re: your mail” is used in the subject field. 

You can change the subject field by backspacing over it and typing a new 
subject. 

5. elm responds with a prompt for the carbon copies. 

Type the mail addresses of any users who should receive a carbon copy of 
the message, then press ("Enter") . 

6. elm brings up a vi editor. 

If you chose yes in reply to the “Copy message” prompt, the editor will be 
invoked with the original message copied into the editing buffer, elm inserts 
the default prefix character (>) and a blank at the beginning of each line of 
the copied message. 

Type an introductory message. 

For help with using the vi editor, see Chapter 4. 
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To configure your workstation to bring up a different editor, see 
“Customizing eim”. 

7. When you are done typing, save the flie. 

8. After you exit the editor, you wiii see the foiiowing message on the screen. 

Please choose one of the following options by the first character: 

E)dit message, edit the H)eaders, S)end it, or F)orget it. s 

9. To change any of the header information for your message (for exampie, 
to add recipients to the Cc iist, change the message subject, or mark the 
message as Urgent), press 

10. To send your message, type s 

11. After you have sent the maii message, the elm main screen reappears and 
dispiays the message “Mail sent! ”. 
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Forwarding Messages 

You may receive messages that you want to forward to someone else, with or 
without adding your own comments. 

1. Move the message pointer to the message you want to forward. 

2. Press Q. The following message appears at the bottom of the screen. 

Command: Forward Edit outgoing message (y/n)? y 

3. Press if you don’t want to edit the forwarded message. 

Press fEnter") If you do want to edit it. 

4. The bottom part of the screen changes to: 

Command: Forward Edit outgoing message (y/n)? Yes 

Send the message to: 

5. Enter the mail address of the person you want to forward the message to. 

To use aliases for recipient names, see “Using Mail Aliases”. 

For example, if you enter donesky. 

Command: Forward To: donesky 

Subject of message: AI Competition (fwd) 

“(fwd)” is attached to the subject automatically. It tells the recipient that 
this is a forwarded message. 

If the message you are forwarding has no subject, “Forwarded mail” is used 
in the subject of message field. The subject field can be edited. 

6. elm responds with a prompt for the carbon copies. 

Type the user addresses of any users who should receive a carbon copy of 
the message, then press fEnter") . 

7. elm brings up a vi editor window. 

If you chose yes in reply to the “Edit outgoing message” prompt, the editor 
will be invoked with the original message copied into the editing buffer, elm 
inserts the default prefix character (>) and a blank at the beginning of each 
line of the copied message. 

8. Type an introductory message. 

For information about using the vi editor, see Chapter 4. 
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9. When you are done typing, save your file. 

10. After you exit the editor, you will see the following message on the screen. 

Please choose one of the following options by the first character: 

E)dit message, edit the H)eaders, S)end it, or F)orget it. s 

11. To change any of the header information for your message (for example, 
to add recipients to the Cc list, change the message subject, or mark the 
message as Urgent), press ©• 

12. To send your message, type s 

13. After you have sent the mail message, the elm main screen reappears and 
displays the message “Mail sent! ”. 
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Saving Messages to a File 

You may want to save important messages for future reference. 

1. To save the current message to a file, at the “Command:” prompt, type: 

Command: s 

2. The following prompt appears: 

Command: Save Message 
File message in: =!username 

■ If you press fEnter] , the message is saved in a file named with the sender’s 
username in the Mail directory in your home directory. 

The equal sign ( = ) is shorthand for /HomeDirectory/Via.il. 

■ To save the message in another file, enter the name of the file (the name 
you enter replaces =!username). For example: 

Command: Save Message 
File message in: =/oldnews 

If the user is Leslie, the current message is saved in the file oldnews in 
the /home/leslie/Mail directory. If the oldnews file already exists, the 
message will be appended to the contents of the file. If the oldnews file 
doesn’t already exist, it will be created. 

3. To save the message in another directory, enter the path name of the 
directory and the name of the file. 

For example: 

Command: Save Message 

File message in: "/messages/oldnews 

If the user is Leslie, the current message is saved in the file oldnews in the 
/home/leslie/messages directory. If the file already exists, the message will 
be appended to the contents of the file. If the oldnews file doesn’t already 
exist, it will be created. 


Caution After you save a message in a file, the message is marked with a 
D for deletion. When you exit elm, the message is automatically 
deleted. 
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Deleting Mail Messages 

After you have read your mail messages, you may want to delete them. 

1. To delete a mail message, highlight the message and press ©• 

A D appears to the left of the message to show that it is marked for deletion. 

2. To move to the next and previous messages, use and 

3. Delete the marked messages at the “Command:” prompt in one of two ways: 

a. To delete the marked messages and quit elm, press elm will ask you 
to confirm this action. 

b. To delete the marked messages without quitting elm, press [$). 

The following screen shows two messages marked for deletion: 



■ 

. 












D 3 

Mar 

11 

Anne Rand (159) 

Results of Meeting 


Messages are marked with a “D” for deletion. 
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Exiting the elm mailer 

When you are in elm, exit by typing at the “Command:” prompt. 

If you have mail, elm responds as follows: 

Command: q Keep mail in incoming mailbox ? (y/n) y 

If you press Q or press [Enter ] , any messages in the incoming mailbox will 
remain there. You will see these messages when you start elm again. 

If you press messages are stored in your home directory in an alternate 
mailbox, called mbox. 
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Mailing a Directory and Contents 

Sometimes you may need to mail multiple flies to another user. You can use 
the HP-UX shar utility to bundle flies and directories into a single distribution 
package. You can then use elm to mail the package. 

The flies can contain any type of data, including executable programs that 
otherwise cannot be mailed. The resulting package can be edited, for example, 
to add a message at the beginning. 

The optional MPower product allows you to send audio, video, and fax messages 
through electronic mail. 

1. To bundle flies, type the following command in a terminal window: 

shar filename > packagename 

You can use more than one filename, separated by spaces. The output of 
shar appears only on your screen unless you redirect the output with > 
packagename. 

For example, to archive all flies with a .tag sufflx in the current directory in 
a file called my archive, type: 

shar *.tag > myarchive f Enter] 

The asterisk * is a “wildcard” that matches any combination of characters. 

2. To unpack a shar package: 

a. Edit the file and delete any mail headers or messages at the top of the file. 

b. Use the sh command with the package name as follows: 

sh package 

When unpacking, the flies and directories in the package are written to 
their original directory path names. 

Using Options for Packing Files 

You can also use options with the shar command. For example, in this 
command: 

shar -CvZ *.tag > myarchive f Enter] 

The -C option adds a line saying-cut here-before the archive. The -v 

option lists the file names as they are packaged. The -Z option compresses the 
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flies so that they require less disk space. For more information on shar options, 
see shar{l) in the HP-UX Reference. 

To pack flies from many directories and unpack them into one directory, use the 
-b option. The original path names are ignored. 

For example, the following command packs flies from two directories: 

shar -b /home/leslie/list /home/leslie/pics/pic.xwd > package [Enter] 

When package is unpacked, list and pic .xwd are placed in the current 
directory. Without -b, the original directories would be recreated during 
unpacking. 

Mailing a Package 

1. Start elm by typing elm at the command prompt. 

2. Press @ to mail a message. 

3. Respond to the prompts for recipient, subject, and copies. 

4. When the editor window opens, read in the package file. 

In vi, press fESC~] , then type :r filename. 

5. Type an introductory message, if desired. 

6. When you are done typing, save your file. 

7. After you exit the editor, you will see the following message on the screen. 

Please choose one of the following options by the first character: 

E)dit message, edit the H)eaders, S)end it, or F)orget it. s 

8. To change any of the header information for your message (for example, 
to add recipients to the Cc list, change the message subject, or mark the 
message as Urgent), press 

9. To send your message, type s 

10. After you have sent the mail message, the elm main screen reappears and 
displays the message “Mail sent! ”. 
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Customizing elm 

The elm mailer has different options you can set to make it more convenient 
for you to use. Among features you can change are the menus that appear on 
the screen, the printer your mail is sent to, and the order in which your mail is 
listed in your mailbox. These are entered automatically in the . elm/elmrc file. 
This file is created by elm and contains your default settings and customizations. 

Using the Options Editor 

To start the elm options editor, press at the elm command prompt: 

Command: o 

You will see a screen similar to the following: 



— Elm Options Editor — 

C)alen,dar file 

/home /leslie/calendar 

D)ispla 7 mail using 

builtin 

E)dit.or 

/usr/bin/vi 

F)older directorj 

/home /leslie/Mail 

S)ort.ing criteria 

received 

0)utbound mail saved 

/home/leslie/mboxout 

P)rint mail using 

Ip —o2 

y)our full name 

Leslie Pendergrast 

A)rrow cursor 

OFF 

M)enu displaj 

ON 

U)ser level 

0 (for Beginning User) 

N)ames onlj 

OFF 

T)abs to spaces 

OFF 

Select first letter of Option line^ to Save^ or R)eturn 

Command: | 


You can configure elm using the options editor. 


Using the screen, you can change the 12 predefined settings in the .elm/elmrc 
file. For information on changing other settings, see Mail Systems: User's Guide. 

1. To select an option to set, type the first letter of the option. For example, to 
change the way messages are sorted, press [0. 

To get information about a specific option in the option menu, type ? and 
then type the first letter of the option. 
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2. Type the new option setting, then press fEnter) . 

3. When you are finished setting options, press Q to save your changes. 

If you do not save the changes, the . elm/elmrc file will not be changed and 
the changes will only apply to the current mail session. 

4. Exit the options editor by pressing fEnter") . 

Example: Changing the Order of Yonr Mail Messages 

1. To change the order in which your mail messages are listed in your mailbox, 
press [0 (the first letter of “S)orting criteria”) in the options editor. 

Command: s 

A message indicates how messages are currently sorted. For example: 

This sort will order most-recently-sent to least-recently-sent 

2. To see different choices for sorting your messages, press the space bar. 

3. When you see the method you want, press fEnter") . For instance, press fEnter") 
when you see: 

This sort will order by sender name 

4. Press f0 to save the change. 

5. To return to your mailbox, press fEnter") again. The messages in your mailbox 
will now appear in alphabetical order by sender name. 

Changing the User Level of elm 

elm provides three user levels: 

■ Level 0, for beginning users. 

■ Level 1, for users familiar with elm. 

■ Level 2, for expert users. 

The user level affects: 

■ Commands displayed in the command menu. 

The frequency of use of each command differs with user level, elm considers 
this difference and tailors the command menu for each user level. 

■ The simplicity of the message. 
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For example, elm displays “lb:” instead of “Send the message to:” in the 
higher user levels. 

■ The handling of a message that was aborted (forgotten). 

The aborted (forgotten) message is an outgoing message that is canceled when 
the “F)orget it” action is taken, in user level 1 or 2, the canceled message is 
stored. This allows you to retrieve the message before exiting elm. 

To change the default user level (Level 0, beginner) to an advanced user level 
(Level 1 or 2), follow these steps: 

1. Press (letter 0, not zero) at the main screen prompt, “Command:” The 
options editor screen appears. 

2. Press at the “Command:” prompt. 

3. Select an advanced user level (1 or 2) by pressing the space bar, then press 

f Enter~) . 

4. Save the setting by pressing [0. 

For more information on using and customizing elm and other mail systems in 
HP-UX, SQQ Mail Systems: User’s Guide. 
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Chapter Command Summary 


Elm Commands 


To do this . .. 

Use this 
elm com¬ 
mand .. . 

Delete the messages marked for deletion 
without quitting elm. 

$ 

Get help on elm commands. 

7 

Send a command to the shell without leaving 
elm. 

j 

Set up mail aliases. 

a 

Change the mailbox. 

c 

Mark messages for deletion. 

d 

Forward the current message to another user. 

f 

Send a group reply to all recipients of the 
original message. 

g 

Move the message pointer to the next message 
(below). 

T 

Move the message pointer to the previous 
message (above). 

A 

Send mail to a specified user or users. 

m 

Set different mail options, including the sorting 
method for messages, the destination of 
printed messages, the type of menus displayed, 
and so on. 

0 

Print messages. (You can change the 
destination of printed messages using the o 
command listed above.) 

P 
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Elm Commands (continued) 


To do this ... 

Use this 
elm com¬ 
mand ... 

Quit elm with the option of changing the 

q 

contents of the mailbox. 


Reply to the author of the current message. 

r 

Save a message to a file. 

s 

Exit elm without making any changes. 

X 
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Communicating over a Network 


Sometimes you may need to get a data file that’s on another computer, or to 
work on a computer that’s not at your desk. 

The easiest way to accomplish these tasks is to use a network. Local area 
networks (LAN) and wide area networks (WAN) allow you to access data and 
use information distributed among many computers. 

If your system is on a network, you can transfer files to and from other 
computers, log in remotely, and run applications or commands on remote 
computers. 


HP-UX Network Services 

Your HP-UX system can use a variety of networking services to enable you 
to transfer copies of files to other computer systems. These services can also 
enable you to log onto remote machines on the network and run commands and 
processes remotely. 

Remote File Systems: NFS 

The HP Network File System (NFS) services allow many systems to share the 
same files. Since NFS is independent of the operating system, it can provide 
data-sharing among heterogeneous systems. Explicit file transfers across the 
network are unnecessary. Since access techniques are transparent, remote file 
access remains similar to local file access. 

For more information about setting up NFS-mounted file systems, ask your 
system administrator, or see Installing and Administering NFS Services and the 
System Administration Tasks. 
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Using Global Networks 

If your computer has access to a network, you may be able to connect to global 
and national networks. These networks allow you to communicate with people 
all over the world by sending electronic mail and reading electronic bulletin 
boards. 

Here are some of the largest academic and research computer networks: 

■ The Internet 

■ BITNET 

■ DECNET 

■ JANET 

■ NFSNET 

■ SPAN 

■ USENET 

Ask your system administrator to determine if you have access to one of these 
networks. 

For information on the Internet, see publications such as The Internet Yellow 
Pages (Osborne), The Internet Navigator (Wiley and Sons), or The Whole Internet 
(O’Reilly and Associates). For more general network information, see the User’s 
Dictionary of Computer Networks, an annual publication of the University 
of Texas System Office of Telecommunication Services. This guide provides 
descriptions of networks, lists of host systems, site contacts, and organizations. 
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Transferring Files Remotely with ftp 

The ftp (File Transfer Protocol) program allows you to do the following tasks: 

■ Copy files over a network connection between your local system and remote 
systems. 

■ Manage files on remote systems for which you have a valid login account. 

Some systems are set up to allow anonymous access to “public” files. This 
capability is referred to as anonymous ftp. 


Note The ftp server on a 10.0 host may deny access to a user if the 

server’s /etc/passwd file is from a 9.X or earlier system. You 
may need to update /etc/passwd to reflect the new paths in 
the V.4 File System. For example, bin/sh should be updated to 
/usr/bin/sh. 


Preparing to Use ftp 

■ If your system has an /etc/hosts file, the system administrator should 
ensure that it contains entries for each remote systems with which you will 
communicate. Each entry contains the following information: 

internet ^address official^name alias 
For example: 

15.15.232.18 hpabc.fc.hp.com hpabc 

■ Have the system administrator for the remote systems arrange to give you a 
password and an account, or a login to someone else’s account, so that you 
can log in on the remote systems. (If the remote system allows anonymous 
ftp, you do not need an account on that system.) 

Starting ftp 

1. To invoke ftp and connect to a remote system in one step, type the following 
in a terminal window: 

ftp remote ^hostname fEnte/] 

2. ftp confirms the connection with the remote system and prompts you for a 
remote login name: 

lame {remote^hostname) : 
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3. To log in with the same remote login name as your local login name, just 

press fEnter") . 

Otherwise, type your login name for that system and press fEnter) . 

To access an anonymous ftp account, use the login name “anonymous” or 
“ftp”. 

4. ftp prompts you for a password: 

Password {remote^hostname) : 

Type the password associated with your remote login name and press fEnter] . 
For security reasons, the password will not appear on the screen. 

To access an anonymous ftp account, use any non-null password 
(by convention, the password should be the host name of your own 
workstation). 

5. ftp confirms this action with a message: 

Password required for remoteAogin^name 
User remoteAogin^name logged in. 

6. To see a list of available commands, press 0 at the ftp> prompt. 

To get help on a particular command, press 0 and type the command name. 

Listing and Creating Directories 

While connected to a remote computer with ftp, you can view the contents of 
directories and move between directories. 

if the remote computer has been configured correctly, you can also create and 
remove directories. 
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To do this ... 

Type ... 

Display the name of the current 
remote working directory 

pwd 

Display the name of the current 
local working directory 

!pwd 

Change the working directory on 
the remote system to 
remote _ directory 

cd remote ^directory 

Change the working directory on 
the local system to 
locals directory 

led local^directory 

List the contents of the current 
remote directory 

Is 

Create a remote directory 

mkdir 

remote _ directory 

Delete an empty remote 
directory 

rmdir 

remote _ directory 

Delete a remote file 

delete remote^file 


Transferring Files from a Remote System 

Use get to transfer flies from a remote system to your local directory. 

1. If you are going to transfer binary flies, such as graphics or executable 
programs, type bin at the ftp> prompt. 

2. At the ftp> prompt, type: 

ftp> get remote^file localjile ["Enter") 

The remote^file can be the name of a file In the remote working directory, 
or a relative or absolute path from that directory. 

If you do not specify localjile, the local destination file name will be the 
same as the remote source file name. 

a. ftp copies the remote file to the local file name. 
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b. If the remote tile is not in the current working directory on the remote 
system, remoteJile is the absolute path name or relative path name for 
that file. In that case, ftp copies the file to a file name with the same path 
on your local system. 

c. If there is no matching path, ftp gives you a message, “lo such file or 
directory 

d. If the destination file already exists, ftp overwrites its contents with the 
contents of the remote file. 

3. During a successful copy, ftp displays messages confirming the copy and the 
length of time required. 

Example 

This example shows user leslie getting the remote file special from 
the remote directory /home/ftp/pub and placing it on the local system as 
new_info. 


$ ftp hpace 

Connec-ted t-o hpace . f c . hp. com 

220 hpace FTP server (Yersion 1.7.109.2 Tue Jul 28 23:32:34 GMT 1992) ready. 
Name (hpace:leslie): leslie 

331 Password required for leslie. 

Password: 

230 User leslie logged in. 

Remote system type is UNIX. 

Using binary mode to transfer files. 
ftp> pwd 

257 "/home/ftp" is current directory. 
ftp> get pub/special new_info 
200 PORT command successful. 

150 Opening BINARY mode data connection for pub/special (1760 bytes). 

226 Transfer complete. 

1760 bytes received in 0.18 seconds (9.58 Kbytes/s) 
ftp> bye 

221 Goodbye. 

$ 

Use ftp to get files from remote systems. 
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Transferring Files to a Remote System 

Use put to transfer flies from your local system to a remote system. 

1. If you are going to transfer binary flies, such as graphics or executable 
programs, type bin at the ftp> prompt. 

2. At the ftp> prompt, type: 

ftp> put localJile remoteJile ["Enter") 

The local^file can be the name of a file In the local working directory, or a 
relative or absolute path from that directory. 

If you do not specify remote Jile, the remote destination file name will be the 
same as the local source file name. 

a. ftp copies the local file to the remote file name. 

b. If the remote file is not in the current working directory on the remote 
system, remote Jile is the absolute path name or relative path name for 
that file. 

c. If the destination file already exists, ftp overwrites its contents with the 
contents of the local file. 

3. During a successful copy, ftp displays messages confirming the copy and the 
length of time required. 

Example 

This example shows user leslie putting the local file new_info onto the remote 
system as the file special in the remote directory /home/ftp/pub. 
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Connec-ted t-o hpace . f c . hp. com 

220 hpace FTP server (Yersion 1.7.109.2 Tue Jul 28 23:32:34 GMT 1992) ready. 
Name (hpace:leslie): leslie 

331 Password required for leslie. 

Password: 

230 User leslie logged in. 

Remote system type is UNIX. 

Using binary mode to transfer files. 
ftp> pwd 

257 "/home/ftp" is current directory. 
ftp> put new_info pub/special 
200 PORT command successful. 

150 Opening BINARY mode data connection for pub/special (1760 bytes). 

226 Transfer complete. 

1760 bytes received in 0.18 seconds (9.58 Kbytes/s) 
ftp> bye 

221 Goodbye. 

$ 


Use ftp to put files on remote systems. 


Exiting ftp 

lb close the connection with the remote system and exit ftp, type: 
ftp> bye fEnter) 
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Copying Files Remotely with rep 

You can use the HP-UX rep (Remote Copy) program to copy flies or directories 
to and from a remote system or to copy among remote systems. 

Preparing to Use rep 

if your system administrator has already configured your system to use remsh, 
you can use rep without any additional setup. 

To use rep, you will need the following: 

■ Read permission on the flies you want to copy, and read and search (execute) 
permission on all directories in the directory path. 

■ An account (login) on the remote system. 

■ A .rhosts file in the remote system’s home directory containing the names 
of your local system and your local login name. 

For example, an entry in the .rhosts file on the remote system might be: 
hpabc leslie 

where hpabc is the name of your local system and leslie is your local login 
name. This allows leslie on hpabc to copy flies back and forth to the remote 
system containing the .rhosts file. 


Note it is important to protect your remote .rhosts file and home 

directory to prevent unauthorized users from gaining rep access 
to your remote account. 

■ Make sure you own the file. 

■ Make sure that you (the owner) have read and write 
permission on the .rhosts file, and that group and other 
have no permissions. 

■ Protect your remote home directory so that owner has read, 
write, and execute permission, group has read and execute 
permission, and other only has execute permission. 

For information on file ownership and permissions, see 
“Protecting Your Files and Directories” in Chapter 7. 


■ A .rhosts file on your local system. This contains the names of all the 
systems you will copy flies to and from. 
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For example: 

hpqrs leslie 
hpxyz leslie 

■ If your system has an /etc/hosts file, the system administrator should 
ensure that it contains entries for the remote hosts with which you will 
communicate. 

The /etc/hosts file has a line containing the following information about 
each remote system: 

internet ^address officiaLname alias 

For example: 

15.15.232.18 hpabc.fc.hp.com hpabc 

Copying Files to a Remote System 

To copy from your system to a remote system, use the following: 

rep local Jile remote ^hostname: remote Jile fEnter") 

Note that, if localJile is not in your current directory, you will need to supply 
the relative path (from your current directory) or the absolute path name 
(from /), in addition to the local file name. 

Specify the complete (absolute) path for the remote Jile on remote ^hostname 
only if you want to place it in a directory other than the remote home directory. 

Examples 

To copy myf lie from your current directory to a remote system called hpxyz: 

rep myfile hpxyz:/home/leslie/otherdir f Enter] 

In this case, myfile will be copied as myfile into the remote subdirectory, 
otherdir. If you had only supplied the remote host name, rep would have 
copied myfile into the remote home directory, also as myfile. 

You can also include a file name in the destination. For example, to copy to a 
system named hpxyz: 

rep myfile hpxyz:/home/leslie/otherfile f Enter] 

In this case, you have copied myfile as otherf ile, in the remote directory 
leslie. 
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Copying Files from a Remote System 

To copy a file from a remote system into your local directory, use the following 
syntax: 

rep remote ^hostname: remote Jile local^file [Enter") 

Example 

To copy myf ile from your account in a remote system hpxyz into your current 
directory: 

rep hpxyz:/home/leslie/myfile . [Enter] 

The dot (.) is shorthand for “current directory”. In this case, myf ile will be 
copied from the remote directory into your current directory as myf ile. 

If you want to copy the file to a new name, supply the destination file name. 

If you want to copy myf ile into another directory in your home system, use a 
path name, absolute or relative, as shown: 

rep hpxyz:/home/leslie/myfile otherdir/ f Enter") 

Or, if you want to copy the file to another file name in another directory: 

rep hpxyz:/home/leslie/myfile otherdir/otherfile [Enter] 


Copying Directories to a Remote System 

To copy a local directory with all its files and subdirectories to a remote system, 
use rep with the -r (recursive) option. 

The syntax is as follows: 

rep -r local^dir remote ^hostname: remote _dir fEnter"] 

If local^dir is not in your current directory, you will need to supply the relative 
path name (from your current directory) or the absolute path name (from /, 
the top of the directory hierarchy), in addition to the local directory name. 

Also, if remote^dir is not in your home directory, the remote^dir will require a 
relative path (from your home directory) or an absolute path (from /). 

For more information, see “Specifying Files and Directories” in Chapter 2. 


Communicating over a Network 6-11 



Example 

To copy an entire subdirectory called work to a directory called products in 
your home directory on a remote computer called hpabc, type the following: 

rep -r work hpabc:/home/leslie/products f Enter] 

This command creates a directory named work, with all its contents, in 
hpabc:/home/leslie/products (provided that /home/leslie/products 
already exists on hpabc). 

The example assumes that you are in the local directory containing work. 
Otherwise, you would have to give a relative or absolute path to that directory, 
such as /home/leslie/work. 


Copying Directories from a Remote System 

To copy a remote directory with all its flies and subdirectories to a local 
directory, use rep with the -r (recursive) option in the following syntax: 

rep -r remote ^hostname: remote _dir local^dir fEnter") 

Example 

To copy a remote directory called work to your current directory, type the 
following: 

rep -r hpabc:/home/leslie/work . f Enter") 

The dot (.) indicates the current directory. The work directory will be created 
in this directory. 
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Logging In to Another Compnter with rlogin 

If you have an account on a remote system, you can use rlogin to log in to that 
system by supplying your remote login name and password. You can then work 
on that system, running commands and applications just as you would on your 
home system. 

Preparing to Use rlogin 

Note that if your system has already been configured to use rep or remsh, you 
can use rlogin without any additional setup. 

■ To use rlogin, you will need an account (login) on the remote system. 

■ If your system has an /etc/hosts file, the system administrator should 
ensure that it contains entries for the remote systems with which you will 
communicate. 

The /etc/hosts file has a line containing the following information about 
each remote system: 

internet ^address ojficial^name alias 

For example: 

15.15.232.18 hpabc.fc.hp.com hpabc 

Logging In on a Remote System 

1. Type this command: 

rlogin remote ^hostname fEnter") 

The remote ^hostname is the name of an appropriately configured remote 
system. This system is named in your /etc/hosts file. 

To log in as another user on the remote system, use the -1 username option. 
By default, you log in with the same user name you are logged in with on 
your local system. This option is useful if you are using someone else’s 
computer and want to log back in to your own system. 

For example, the following command lets user leslie log in to remote 
system hpabc from a local system where another user is already logged in. 

rlogin hpabc -1 leslie f Enter] 

2. Enter your remote password. 
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The remote system logs you in with the login message and the remote 
prompt. 

if you make an error in entering your password, the remote system gives you 
the error message, Login incorrect, and prompts you for your login and 
password again. 

Logging Out and Exiting the Remote System 

You can log out of the remote system just as you would from your home system, 
by typing: 

exit fEnter] 

Typing fcTRij -fb^ also logs you out on most system. 

At this point you are logged out of the remote system, disconnected, and 
returned to HP-UX on your local system, which displays a message and your 
local prompt: 

Connection closed. 

$ 

Temporarily Returning to Your Local System 

To execute a command on your local system while you are in rlogin, type the 
rlogin escape character (normally a ") followed by ! and the command to 
execute locally. (The will be invisible until you type the “! ” after it.) After 
the command has executed, rlogin returns you to the remote system. 

Example 

To print the current working directory on your local system while logged in on 
a remote system, use the following command, in this case, the current local 
directory is /home/leslie. 

" ! pwd fEnter] 

/home/leslie 
[Returning to remote] 

Press fEnter") , or enter a command to redisplay the remote system prompt. 
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Running a Command Remotely with remsh 

The remsh command enables you to execute a command on a remote system 
without logging in to that system. 

Preparing to Use remsh 

The remote system must be configured as follows: 

■ You must have an account on the remote system with the same login name as 
your local login name. 

■ The name of your local system and your local login name must be in a 
.rhosts file in your home directory on the remote system. 


Note A /HomeDirectory/ .rhosts file creates a significant security 

risk. 

it is important to protect your remote .rhosts file and home 
directory to prevent unauthorized users from gaining rep access 
to your remote account. 

■ Make sure you own the file. 

■ Make sure that you (owner) have read and write permission 
on the .rhosts file, and that group and other have no 
permissions. 

■ Protect your remote home directory so that owner has read, 
write, and execute permission, group has read and execute 
permission, and other only has execute permission. 

See “Protecting Your Files and Directories” in Chapter 7 for 
information on permissions. 


For example, if your local system’s name were hpabc .hp. com and your 
local login name were j im, you would create on the remote system a 
/HomeDirectory/ .rhosts file with the following entry: 

hpabc.hp.com jim 

See the Using Internet Services manual for more details on using and 
configuring remsh. 
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Running a Command Remotely 


Note Do not use remsh to run an interactive command, such as vi or 

more. With some interactive commands, remsh hangs, lb run 
interactive commands, log into the remote system with rlogin. 


At your HP-UX prompt, enter: 

remsh remote ^hostname command fEnter") 

where remote ^hostname is the name or alias of a remote system and command 
is a command to execute on the remote system. 

You can also set remsh to display the windowed command output on your local 
system. 

At your HP-UX prompt, enter: 

remsh remote_hostname command -display system:display.screen 

where: 

remote ^hostname The name or alias of a remote system. 

command The program you want to run on the remote system. 

system:display.screen The system and display the results are to be displayed 

on. screen is optional. 


Examples 

To copy the file special to the file special .old in your home directory on 
hpabc, use this command: 

remsh hpabc cp special special.old f Enter] 

remsh executes the command on the remote system, and then your local system 
redisplays its prompt. 

To run xload on the remote system named there and direct output back to 
your system, here, use this command: 

remsh there -n /usr/bin/Xll/xload -display here: 0 & f Enter] 

The -n option closes the standard input and prevents remsh from using input 
not intended for it. 
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Chapter Command Summary 


Networking Commands 


To Do This .. . 

Type This .. . 

Start ftp and connect to remote ^hostname 

ftp remote ^hostname 

Get help in ftp 

? or ? command 

Copy flies from remote ^hostname to current 
directory, in ftp 

get remotejile 

Copy flies from your local current directory to 
the current directory on remote Jiostname in 
ftp 

put loealjile 

List the contents of the current remote 
directory 

Is 

Change the current remote directory to 
remote^dir 

ed remote^dir 

Change the current local directory to local^dir 

led local^dir 

Exit ftp 

bye 

Copy localJile to a remote system, using rep, 
with full path names. 

rep loealjile 
remote ^hostname : 
remote^file 

Copy a file from a remote system to your local 
directory, using rep, with full path names. 

rep remote Jiostname: 
remote^file loealjile 

Copy a directory structure from your local 
system to a remote system 

rep -r local^dir 

remote ^hostname : remote^dir 

Copy a directory structure from a remote 
system to your local system 

rep -r 

remote ^hostname : remote^dir 
local^dir 

Log in on a remote system 

rlogin remote ^hostname 

Set the display to a local system 

DISPLAY=feosi%ame: 0; export 
DISPLAY 

Exit rlogin 

exit 
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Networking Commands (continned) 


To Do This ... 

Type This .. . 

Run a command on a remote system 

List the contents of a remote home directory 

remsh remoteJiostname 
command 

remsh hostname Is 
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7 


Making Your System Secure 


HP-UX provides many security features to protect flies from unauthorized 
access. However, you need to follow good security practices to maintain 
security on your system. The degree to which you need to enforce security 
measures depends on where you work, the security policy in your workplace, 
and the type of information with which you work. 
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Security Strategies 

This chapter summarizes the security strategies you should follow to help keep 
your system secure: 

■ Become familiar with the security policies of your workplace. 

■ Keep your terminal secure. 

■ Choose a secure password, and protect your password after you have chosen 
it. 

■ Be aware of who has permission to access your files and directories, and be 
able to control such access. 


Note Security requires ongoing attention, and it may be impossible 

to have a 100% secure system under all circumstances. This 
chapter provides some guidelines for securing your system. 
However, even these cannot guarantee you a completely secure 
system. 
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Securing Your Terminal 

When you are working with sensitive material, take care to position your 

terminal so the screen is not visible to others. Never leave your terminal 

unattended. Log off (exit) when you leave your terminal. 

Guidelines for Securing Your Terminal 

When working with sensitive material, take these security precautions: 

■ Position your terminal so the screen points away from open windows and 

doors. 

■ Never leave your terminal in a non-secure state: 

□ Exercise care when logging in. Make sure no unauthorized person is 
observing you while you’re entering your password. 

□ Log off if you will be away from your terminal for a time. 

□ Clear your display, even if you leave your terminal for a brief period. Type 
clear at the command line prompt. (Note that the clear command clears 
only the current screen; one can still scroll up and see previous screens.) 


Note Check the security policies in your workplace. You may be 

required to log off whenever you leave your terminal, even if 
only for a brief period. 


Workiug iu au Audited Euviroumeut 

HP-UX provides the capability to audit computer use, both on an individual and 
system-wide basis. Depending on how your system is configured, your actions 
may be recorded by an audit program. This subsystem monitors user actions at 
your terminal and records security-relevant information. 
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Choosing a Secure Password 

When you choose a password, you want to ensure that no one can guess what 
you chose. If someone knows your password, that person may log in and access 
your flies. This section offers suggestions on how to select and protect your 
password. These guidelines are of particular significance if you work with 
sensitive material. 

What is a Secure Password? 

When selecting a password in a secure environment, follow these guidelines: 

■ Choose a password that is not publicly associated with you (your personal or 
professional life, your hobbies, and the like): 

□ Don’t use your name, your spouse’s name, your children’s names, or your 
pets’ names. 

□ Don’t use the name of your street or your car. 

□ Don’t use phone numbers or special dates (anniversaries, birthdays, and the 
like). 

□ Don’t use your address, social security number, or license plate numbers. 

■ Choose a password that is not listed in the dictionary (spelled either forwards 
or backwards). Password-cracking programs can use dictionary lists. 

What can you use as a password? Here are a few suggestions: 

■ Make up a nonsense word. 

■ Make up an acronym. 

■ Misspell a word intentionally. 

■ String together syllables from a favorite song or poem. 


Note HP-UX requires that your password be six to eight characters 

long. At least two of these characters must be letters (uppercase 
or lowercase); at least one character must be either a numeral 
(the digits 0 through 9) or a special character (such as -, _, or 
$). 

See “Changing Your Password” in Chapter 1 for some examples. 
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Protecting Your Password 

When you have chosen your password, follow these guidelines to ensure that no 
one discovers it: 

■ Never write down your password. 

■ Don’t tell others your password. 

■ Don’t let others watch as you type your password. 

■ Don’t store your password in the function keys of a terminal. 

■ Change your password occasionally (for example, once every three or four 
months). 

See “Changing Your Password” in Chapter 1 if you need information on how 
to change your password. 

■ if you use more than one computer, use a different password for each system. 
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Protecting Your Files and Directories 

Three classes of users can access flies and directories: owner, group, and other. 
For each of these classes of users, there are three types of access permissions: 
read, write, and execute. 

Who Has Access? 

The three classes of users are: 

■ Owner — Usually the person who created the file. 

■ Group — Several users that have been grouped together by the system 
administrator. For example, the members of a department might belong to the 
same group. 

■ Other — All other users on the system. 

What Kind of Access? 

The access permissions on a file or directory specify how it can be accessed by 
the owner, group, and other user classes. 


A Comparison of Permissions for Directories and Files 


Permission 

Means This For a Directory 

Means This For a File 

read (r) 

Users can view names of flies 
and directories in that 
directory. 

Users can view the 
contents of the file. 

write (w) 

Users can create, rename, or 
remove flies or directories 
contained in that directory. 

Users can change the 
contents of the file. 

execute (x) 

Users can view the contents of 
flies within the directory, and 
run commands, scripts, and 
programs within that 
directory. 

Users can execute 
(run) the file (if it is an 
executable file or 
script) by typing the 
filename at the 
command line prompt. 


You should always be aware of the permissions assigned to your flies and 
directories. Check your flies and directories periodically to make sure 
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appropriate permissions are assigned. If you find any unfamiliar files in your 
directories, report them to the system administrator or security officer. 

Always carefully consider the permissions you allow on your files and 
directories. Give others access to them only when you have good reason to do 
so (if you are working on a group project, for example, your group may need 
access to certain files or directories). 

Using the 11 Command to Display Access Permissions 

The 11 (tong dsting) command displays the following information: 

■ Whether the item is a file or directory. 

■ The access permissions for each of the three classes of users (owner, group, 
and other). 

■ Number of links. 

■ Name of the owner. 

■ Name of the group. 

■ Size in bytes. 

■ Date and time of last modification. If the time of last modification was more 
than six months ago, the year is substituted for the hour and minute of the 
modification time. 

Displaying File Permissions 

To see the permissions, owner name, and group name on myf lie, for example, 
type the following: 

11 myflie 

When you press (Enter") , you should see something like this: 

-r¥-r—r— 1 leslie users 154 Nov 4 10:18 mvfile 

I I I I I I 

permissions owner group size date file name 

The first dash on the left indicates that myf lie is a file (if myf lie were a 
directory, you would see a d in place of the dash). 

Here is a closer view with all permissions indicated (note that the permissions 
are in sets of three): 

rwx rwx rwx 

I I I 

owner group other 
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If a permission is not allowed, a dash appears in place of the letter. In the 
example above (-rw-r—r—), owner (leslie) has read and write permission 
(rw-); group (users) and other have only read permission (r—). 

Displaying Directory Permissions 

To display permissions showing owner, group, and other for a specific directory, 
use the 11 command with the -d option. 

For example, to see the permissions on the projects directory below the 
current directory, type the following: 

11 -d proj ects Follow the 11 command with a -d and the directory name. 
When you press fEnter") , you should see something like this: 

dr¥xr-x- 1 leslie users 1032 Nov 28 12:38 projects 

The first character (d) in the long listing above indicates that projects is a 
directory. The next nine positions (three sets of three) indicate the read (r), 
write (w), and search (x) permissions for owner, group, and other. 

If a permission is not allowed, a dash appears in place of the letter. Here is a 
closer view with all positions indicated: 


d 

1 

rwx 

1 

rwx 

1 

rwx 

1 

1 

directory 

1 

owner 

1 

group 

1 

other 


Then, in the original example above (drwxr-x-): 

The owner (leslie) has read, write, and search permission (rwx); group (users) 

has read and search permission (r-x); other has no access (-) to the projects 

directory. 

Guidelines for Access to Sensitive Files 

Make sure that permissions assigned to sensitive files and directories are 
appropriate. Here are some general suggestions: 

■ Only you should be able to write to your home directory. 

■ Only you should be able to write to the files used to customize your home 
environment, for example, .login and .profile (.profile is discussed in 
Chapter 3, in this manual, and in the Shells: User’s Guide). 

m Only you (and the pseudo-group “mail”, assigned to the mailer) should be able 
to write to your mailflle /var/mail/r<.ser%ame. 
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For More Information ... 

To learn more about the 11 command, see the reference in the HP-UX 
Reference. 

For information on access control lists (ACLs), which allow finer control of 
access to flies, see ac?(5) in the HP-UX Reference and the System Administration 
Tasks. 
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Changing File or Directory Ownership 

To change the owner of a file, use the chown (“change owner”) command. The 
file’s owner and the superuser are the only ones who can change a file’s 
permissions. 

For example, to give user george ownership of the scores file, use this 
command: 

chown george scores 

The owner can either be a decimal user ID or a login name found in the 
/etc/passwd file. You can see the file’s current owner by typing 11 filename. 

if you are changing the owner of a file, you may want to change the file’s group 
at the same time. 

For example, this command changes both the owner of the file and the group to 
which the file belongs: 

chown george:team scores 
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Changing Who Has Access to Files 

To change who has read, write and execute permission on your flies, use the 
chmod (change mode) command. In general, give others access to your flies only 
when you have good reason to do so (if you are working in a group project, for 
example, your group may need access to certain flies). 

Using chmod to Set File Permissions 

You can specify permissions for chmod using the letters u, g, and o, as symbolic 
code for the owner (“user”), group, and others (the class). This “symbolic 
mode” is easy to remember, since the symbols r, w, and x (the mode) are used 
directly as arguments in the command. 

The chmod syntax uses the + , -, and = signs. The syntax is: 

chmod class\_±=]mode,[. ... ] filename 

For example, you can use the symbolic mode to create rw-r—r— permissions 
by specifying the symbols rw, r, and r directly in the chmod command. “User” 
is represented by u, “group” by g, and “other” by o. To assign the permissions 
absolutely, use the = sign in the argument. Unspaced commas separate class 
permissions: 

chmod u=rw,g=r,o=r myfile 

When permissions are being set the same, you can also combine the arguments 
as: 


chmod ugo=r myfile 

With only read permission on myfile, no one can write to it. Also, if you now 
try to remove myfile, the rm command asks you whether you really want to 
remove the file: 

rm myfile 

myfile: 444 mode? (y/n) n If you do not want to remove it, enter n. 

If you do want to remove it, enter y. 

To create rw-permissions and set “no permissions” for the classes g and 

o, use = with no symbol following: 

chmod u=rw,g=,o= filename 

Permissions are added with the + sign. Again, separate each class-permission 
with a comma and no space: 
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chmod u+rw,g+r,o+r filename 

You can also subtract permissions from u, g, or o, using to restrict the level 
of permission from a previous “higher” level. For example, if you had set 
rwxrw-rw- and you wanted to change this to rwx-: 

chmod g-rw,o-rw filename 

However, unless you began with no permissions you may find that using + or 
- has added to, or subtracted from, some previously existing permissions for 
that file. Run the 11 command to check this, if in doubt, set the permissions 
absolutely by using =. 

Later, if you want to permit yourself and members of your group to read from 
and write to myf lie, use chmod as follows: 

chmod ug=rw,o=r myflie 

The 11 command now should show: 


-r¥-r¥-r— 1 leslie users 154 Nov 4 10:18 myfile 


Here is a summary of the various chmod commands you can use to protect 
myfile. 

To Set Permissions so that ... Type This ... 

Only you can read from myfile, chmod u=r,g=,o= myfile 
and no one (including you) can 
write to it. Set permissions to 

-r-. 


Everyone can read from myfile, chmod ugo=r myfile 
but no one can write to it. Set 
permissions to -r--r--r--. 

Only you can write to myfile, chmod u=rw,go=r myfile 
but everyone can read it. Set 
permissions to -rw-r--r--. 

Only you and members of your chmod ug=rw,o=r myfile 
group can write to myfile, but 
everyone can read it. Set 
permissions to -rw-rw-r-- 


Everyone can read from or write chmod ugo=rw myfile 

to myfile. Set permissions to 

-rw-rw-rw-. 
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Only you can read from or write chmod u=rw,go= myf ile 
to myf ile, but no one else can. 

Set permissions to -rw- 
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Changing Who Has Access to Directories 

In addition to changing permissions on flies, the chmod command can also 
change permissions on directories. For example, you can protect a directory so 
that no one can alter its flies. 


The following examples assume that the directory projects exists under your 
current working directory. 

To Set Permissions to . .. Type This ... 

Allow other users to list and chmod u=rwx,go=rx projects 

access the flies in proj ects, 

but not to create or remove 

flies from it. Set permissions 

to drwxr-xr-x. 


Allow all users to list, create, chmod ugo=rwx proj ects 
remove, and access flies in 
projects. Set permissions to 
drwxrwxrwx. 


Allow only yourself to list, chmod u=rwx,go=- projects 
create, remove, and access 
flies in proj ects. Set 
permissions to drwx-. 


Note When determining who should be allowed to use your 

directories, be aware that anyone who can write to a directory 
also can remove or rename a file in that directory— if that 
person cannot write to the file. 


For More Information ... 

This section covered some of the most common uses of the chmod command for 
protecting flies and directories. To learn more about chmod, see the chmod(l) 
man page in the HP-UX Reference. 
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Controlling Defanlt Access Permissions 

In the previous two sections, you learned how to change the permissions on 
individual flies and directories using the chmod command. You should also be 
aware of the default permissions assigned to all of your flies and directories at 
the time you create them. You can list or change the default permission settings 
by using the umask command. 

Default file permissions are assigned by the system whenever you create a new 
file or directory, and these are governed by your umask setting. The default 
umask setting is 0, which means that new flies are created with read/write 
permission for everyone (-rw-rw-rw-) and new directories are created with 
read/write/search permission for everyone (drwxrwxrwx). 

To restrict these default permissions for newly-created flies and directories, use 
the umask command. 

When a new file is created, each bit in the file mode creation mask that is set 
causes the corresponding permission bit in the file mode to be cleared (disabled); 
hence the term mask. Conversely, bits that are cleared in the mask allow the 
corresponding file mode bits to be enabled in newly created flies. 

The umask command built into the POSIX and Key shells accepts symbolic mask 
values (as well as the obsolescent numeric form). These symbolic mask values 
are similar to those used with the chmod command (see chmodfl)). 

umask syntax is as follows: 

umask who operator permissions 

where the parameters have the following meaning: 

who One, two, or all of the following characters: 

■ u (for user permissions) 

■ g (for group permissions) 

■ o (for other permissions) 

■ a (short form for ugo) 

If the who character is omitted, operator and permissions apply to 
all categories (same as a or ugo). 

operator One of the characters +, -, or =. 

■ + means clear the file mode bits represented by the accompanying 
who and permissions values in the mask, thus enabling 
corresponding permissions in newly created flies. 
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■ - means set the tile mode bits represented by the specified who 
and permissions values in the mask, thus denying corresponding 
permissions in newly created files. 

■ = means clear the file mode bits specified by the corresponding 
who and permissions values and set all others. 

permis- One of the characters or character combinations r, w, x, rx, wx, rw, 
sions or rwx, specifying read, write, and/or execute (search) permission 

for the corresponding who and operator. 

If permissions is not specified, no change is made to the existing 
file creation mode mask for the corresponding who. 

For example, to set the umask value to produce read, write, and execute 
permissions for the file’s owner and read-only permission for all others 
(-rwxr—r—) on newly created files, you would enter this: 

umask u=rwx,g=r,o=r 

To set the umask value to produce read, and write permissions for the file’s 
owner, read-only for users in the same group, and no access for others 
(-rw-r-), enter the following: 

umask a-rwx,u+rw,g+r 

To determine your current umask setting, type: 

umask -S 


Note You should not set a umask value that restricts your access 

permissions to your own files. A number of HP-UX utilities, such 
as vi, assume that you can always access newly-created files. 
Such files might include the temporary files that vi creates. 
These utilities may malfunction when used under such a 
restrictive umask setting. 


If you set umask at a shell prompt, it will apply to shells and subshells in the 
current login session only. It won’t apply to future login sessions. To apply a 
umask setting automatically at login, add the umask command to your .profile 
(POSIX and Bourne Shell users) or .login file (C Shell users). 
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For More Information ... 

For more information about the umask command, see the umask{\) man page in 
the HP-UX Beference. 

To learn more about the .profile and .login flies, see the Shells: User’s 
Guide. 
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Obtaining Software Secnrity Patches 

The U.S. Computer Security Act of 1987 stipulates that if financial loss occurs 
due to computer fraud or abuse, the company, not the perpetrator, is liable for 
damages. 

To protect system and data integrity, HP recommends that you establish a 
comprehensive security policy to govern computer use. HP provides up-to-date 
software patches to close known security problems that allow unauthorized root 
access to your system. 

For information on available HP-UX security patches, contact HP support at: 
supportOsupport.mayfield.hp.com 

or access the World-Wide Web (WWW) using a client such as Mosaic with this 
URL: 

http://support.mayfield.hp.com 
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Chapter Command Summary 

To Do This ... Type This . .. 

Display access permissions 11 
of flies and directories. 

Add or subtract access chmod class±permissions name 
permissions. 

Change access permissions chmod class=permissions name 
absolutely. 

View current mask setting, umask -S 

Change permissions mask umask who operator permissions 
setting. 
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HP-UX Quick Reference 


The following table summarizes the most useful HP-UX commands. To make it 
easier to refer to selected commands, copy or tear out these pages and place 
them near your display. 

How to use this Reference: 

1. Type the commands as they are shown in the second column below. 

2. Include paths with file names, if you are working with different directories. 

3. Follow each command with [Enter") . 

4. To get more information on a specific command, type man command^name. 
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To Do This ... 

Type This .. . 

Working with Directories 

Show current working directory 

pwd 

Change directory 

cd directory_path 

Change to home directory 

cd 

Create a directory 

mkdir directory_name 

Remove an (empty) directory 

rmdir directory_name 

Working with Files 

Read mail 

elm 

List flies and directories in current directory 

Is 

List all flies or directories, including invisible 
(“dot”) flies 

Is -a 

List flies, and mark directory names with “ / ” 

Isf 

Compress a file 

c omp zessfi lename 

Uncompress a file 

uncompress filename 

Create or edit a file 

vi file^name 

Display file contents 

more file^name (q to quit) 

Display the first 10 lines of a file 

head file^name 

Display the last 10 lines of a file 

tail file^name 

Copy a file 

cp file^name file^copy 

Move a file to a new file name 

mv oldjile newjile 

Append Jrtei onto the end of file2 

cat filel » file2 

Removefile 

no. file 

Remove a directory dir_name and all its flies 

rm -rf dir_name 

Check the spelling in a file 

spell file^name 
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To Do This .. . 

Type This ... 

Printing 

Print a file 

Ip file^name 

Determine printer status 

Ipstat -t 

Cancel a print request 

cancel requested 

Finding and Organizing 

Find flle(s) beginning with x in current and 
subdirectories 

find . -name ’x*' 

Find all occurrences of word in all flies in 
current directory 

grep word * 

Sort listfile alphabetically 

sort listfile 

Display date and time 

date 

List all command aliases 

alias 

Find HP-UX command information 

man command^name 

Determine PATH setting 

echo $PATH 

Determine what shell you’re in 

echo $SHELL 

Security Operations 

Create or change password 

passwd 

Display permissions for a file 

11 file^name 

Display permissions for a directory 

11 -d directory_name 

Change file or directory permissions 

chmod class=permissions 
name 

Change file or directory ownership 

chown user name 
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To Do This ... 

Type This .. . 

System Operations 

Clear screen 

clear 

Set command-line editor 

set -0 editor^name 

Edit your command line (in Korn/Key/Posix 
Shell set for vi) 

fESC~] (use vi commands) 

Recall previous command line (with vi editor) 

fESC~] k (back) or j (forward) 

Execute previous command line 

[Enter") (wheu line is displayed) 

Set terminal type (select term^type from 
/usr/lib/terminfo) 

lERn=term_type 

List current process status and PIDs 

ps -ef 

Kill (terminate) a process 

kill PID 

Create or change a password 

passwd 

Redirect input from a file to a command 

command < injile 

Connect two processes with a “pipe” 

commandl I command^ 
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Doing Advanced HP-UX Tasks 


For advanced 
users 


Occasionally you may need to perform more advanced 
configuration or system administration tasks. These tasks 
frequently require superuser permission and a more advanced 
knowledge of HP-UX. To run SAM, ensure you have superuser 
permission, then enter /usr/sbin/sam on the command line. 

The following tables list advanced tasks for HP-UX, and 
provide references to additional information. 


Doing Advanced HP-UX Tasks B-1 




Advanced HP-UX Tiisks 


Tksk 

Where to Look 

System Administration Tksks 

Using SAM, the 
System 

Administration 

Manager. 

See the System Administration Tasks manual. You can also 
run SAM and look at the extensive online help available in 
SAM. 

Getting 

information on 

system 

performance. 

Run SAM, select and open “Process Management”, then 
select and open “Performance Monitors”, then select and 
open one of the available performance tools. 

Displaying disk 
usage. 

See the dv{l) man page in the HP-UXPeference 

Recovering disk 
space. 

Run SAM, select and open “Routine Tasks”, then select and 
open “Selective File Removal”. 

Rebooting a 
system. 

See the System Administration Tasks manual. Chapter 2. 

Changing the 
system run level. 

See the System Administration Tasks manual. Chapter 1. 

Command Usage Thsks 

Running a 
command at a 
specified time 

See the crontab{ l) man page in the HP-UX Reference. You 
can also run SAM, select and open “Process Management”, 
then select and open “Scheduled Cron Jobs”, then select 
“Add” from the “Actions” menu. 

Network Thsks 

Using a remote file 
system (NFS) 

See the manuals System Administration Tasks, Chapter 4, 
and Installing and Administering NFS Services. 

Installing or 
updating from a 
network server. 

See the Installing HP-UX 10.0 manual. 
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Advanced HP-UX Tksks (continued) 


Tiisk 

Where to Look 

File Tksks 

Backing up flies or 
directories. 

See the System Administration Tasks manual, Chapter 9. 
You can also run SAM, select and open “Backup and 
Recovery”, then select and open either “Automated 
Backups” or “Interactive Backup and Recovery” and enter 
the appropriate information (see SAM online help for more 
specific information). 

Restoring flies or 
directories. 

See the System Administration Tasks manual. Chapter 9. 
You can also run SAM, select and open “Backup and 
Recovery”, then select and open “Interactive Backup and 
Recovery”, then choose “Recover Files and Directories” 
from the “Actions” menu. 

Printer and Peripheral Thsks 

Getting 

information on 
printers. 

See the lpstat{l) man page in the HP-UX Inference. You 
can also run SAM, select and open “Printers and Plotters”, 
then select and open “Printers and Plotters”. 

Enabling or 
disabling a printer. 

Run SAM, select and open “Printers and Plotters”, then 
select and open “Printers and Plotters” again, highlight 
one of the printers listed, then choose the appropriate 
action from the “Actions” menu. 

Adding or 
removing printers 

See the System Administration Tasks manual. Chapter 10. 
You can also run SAM, select and open “Printers and 
Plotters”, then select and open “Printers and Plotters” 
again, highlight one of the printers listed, then choose the 
appropriate action from the “Actions” menu. 

Diagnosing a 
printing error 

See the System Administration Tasks manual. Chapter 10. 
You can also run SAM, select and open “Printers and 
Plotters”, then select and open “Printers and Plotters” 
again, highlight one of the printers listed, then choose 
“Show Common Problems” from the “Actions” menu. 
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Advanced HP-UX Tiisks (continued) 


Tiisk 

Where to Look 

Printer and Peripheral Thsks (continued) 

Selecting system 
default printer. 

See the System Administration Tasks manual, Chapter 10. 
You can also run SAM, select and open “Printers and 
Plotters”, then select and open “Printers and Plotters” 
again, highlight one of the printers listed, then choose “Set 
as System Default Destination” from the “Actions” menu. 

Adding or 
removing 
peripherals. 

See the manuals System Administration Tasks, Chapter 1, 
and Configuring HP-UX for Peripherals. You can also run 
SAM, select and open “Peripheral Devices”, then select 
and open the appropriate area for the type of peripheral 
you want to add. 

Configuration Thsks 

Modifying login 
scripts (.prof ile, 
.kshrc, etc.). 

See the Shells: User’s Guide. 

Setting and 
referencing 
environment 
variables. 

See Chapter 3 in this manual and also the Shells: User’s 
Guide. 

Modifying or 
viewing user 
information. 

Run SAM, select and open “Accounts for Users and 

Groups”, then select and open “Users” and use the 
“Actions” menu to select what you want to do to a user 
account. Also see the System Administration Tasks 
manual. Chapter 1. 

Modifying a user’s 
group ID. 

Run SAM, select and open “Accounts for Users and 

Groups”, then select and open “Users”, highlight the user, 
then select “Modify Group Membership” from the 
“Actions” menu. Also see the System Administration 

Tasks manual. Chapter 1. 

Removing a user. 

Run SAM, select and open “Accounts for Users and 

Groups”, then select and open “Users”, highlight the user, 
then select “Remove” from the “Actions” menu. 
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Glossary 


absolute path name 

The full path name of a file, including all the directories leading to it, 
starting with root (/) and ending with the file name itself. For example, 
/home/michael/myf ile is an absolute path name. 

See also file, file name, path name, relative path name, 
access permissions 

File characteristics (including read, write, and execute permission) that 
determine if a process can perform a requested operation on the file (such as 
opening a file for writing). 

Hence, access permissions control who can read or alter flies or directories. 
They define read, write, and execute permissions for the Ale’s owner, 
members of the Ale’s group, and all others. 

alias 

An alternative name for a person or a list of people, used as a shortcut when 
sending electronic mail. 

For example, if you often send mail to someone whose mail address is 
ChristineOmarket. elm.com, you could set up the alias chris. Then you 
could send mail just to chris instead of typing the entire address. 

application 

See software application, 
argument 

The part of a command line that identifles what element (Ale, directory, etc.) 
is to be acted upon. 

background process 

A program, usually low priority, run non-inter actively by the shell without 
terminal i/0, while other processing occupies the terminal. Place an 
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ampersand (&) at the end of a command line to cause that command to be 
run as a background process. 

backup 

A copy of all or part of the file system. 

boot 

To start up your system, loading it into the computer memory. 

Bourne Shell 

A command interpreter. As of the HP-UX 10.0 release, the OSF POSIX shell 
replaces the Korn Shell and Bourne Shell. Thus, /usr/bin/sh will be the 
POSIX shell. However, /usr/old/bin/sh will still contain the Bourne shell. 

CD-ROM 

Compact Disc Read-Only Memory. 

CD ROM file system 

A read-only memory file system on compact disk. You can read data from a 
CD ROM file system, but you cannot write to one. 

cluster 

A group of workstations connected via a LAN. One computer, the cluster 
server, performs as a server to the cluster. It provides file access, login 
access, file transfer, printing and other services across the network to the 
cluster nodes. 

command interpreter 

A program that reads lines of text from standard input (typed at the 
keyboard or read from a file), and interprets them as requests to execute 
other programs. An HP-UX command interpreter is called a “shell”. 

command line prompt 

A command line prompt shows that the computer is ready to accept your 
commands. Each terminal window has a command line prompt that acts just 
like the command line prompt that would be shown if your computer was 
not running HP VUE. Usually the command line prompt is "/., >, or $. You 
can find the command line prompt by pressing fEnter] in an HP VUE terminal 
window. 

control key 

The keyboard key, normally labeled “CTRL”, that is used as a modifier key. 
You hold down this key while pressing another key. 
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C Shell 

An HP-UX command interpreter, invoked as csh. 
current working directory 

The directory in which you are currently located. Relative path name 
searches begin in this directory. It is also called the working directory. 

cursor 

An image used to indicate the focus of keyboard input. The cursor can have 
several forms. For instance, the text entry cursor appears as an I. 

directory 

An organizational unit of your workstation’s disk drive, composed of files 
and subdirectories. A directory is analogous to a file folder containing letters 
(text files), which is contained in a filing cabinet (disk). 

environment 

The set of defined shell variables (some of which are PATH, TERM, SHELL, 
HOME) that define the conditions under which your commands run. These 
conditions can include your terminal characteristics, home directory, and 
default search path. These variables are set in your .profile. 

execute permission 

Users with execute permission on a file can execute (run) the file as a 
program by typing the file name at the command prompt. If the file is a 
directory, they can access the directory’s contents. 


file 

The basic named unit of data stored on disk. See also directory, file name, 
file access permissions 

File name characteristics (including read, write, and execute) that determine 
whether a process can perform a requested operation on the file (such as 
opening a file for writing). Access permissions can be changed by a chmodil) 
command. 

file name 

The name given to a particular file. See also file, absolute path name, 
relative path name, and path name. 

file system 

The organized set of files and directories on a hard disk. 
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filter 

A command, such as cat, grep, or sort, that reads data from the standard 
input, performs a transformation on the data, and writes it to the standard 
output. 

font 

A complete set of characters (letters, digits, and special characters) of one 
size and one typeface. “Ten-point, Helvetica, bold” is an example of a font. 

foreground process 

The process occupying the currently active terminal I/O, which may be a 
window. The shell will not return a prompt until a foreground process has 
finished executing. 

group 

An association of users permitted to access the same set of files. The 
members of a group are defined in the files /etc/passwd, /etc/group, and 
/etc/logingroup (if it exists) via a numerical group ID. Users with identical 
group IDs are members of the same group. 

group access list 

The group access list is a set of supplementary group IDs, associated with a 
process, used in determining resource accessibility. 

$HOME 

The value of the environment variable representing the home directory, 
home directory 

A personal directory where you keep files and additional subdirectories that 
belong to you. By default. File Manager and Terminal Emulator windows are 
set to your home directory when you first open them. 

/HomeDirectory/ 

Symbolizes your home directory. For example, if your home directory 
is /home/anna/, then /HomeDirectory/hitmajps/smile .hm represents 
/home/anna/bitmaps/smile.bm. 

host name 

The unique identifying name given to a system in a network. There are 
generally different host name domains associated with different networks. 
Also called node name. For example, hpabc. 
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invisible file name 

A file name in which the first character is a dot (.)• Invisible file names are 
not displayed by the HP-UX listing commands such as Is and 11 unless you 
use the -a option. 

keysh 

The command for invoking a Key Shell. 

Key Shell 

An HP-UX shell which, as an extension of the Korn Shell, uses hierarchical 
softkey menus and context-sensitive help to aid users in building command 
lines. Invoked as usr/bin/keysh. 

Korn Shell 

An HP-UX shell, featuring command history recall and line-editing. Invoked 
as /usr/bin/ksh. As of the 10.0 Release of HP-UX, this shell is obsolete, 
replaced by the POSIX shell. 

LANG 

An NLS environment variable used to inform a computer process of the 
user’s requirements for “native language,” “local customs,” and “coded 
character set. ” 

LAN 

Stands for Local Area Network. The systems and/or clusters that share data, 
hardware, and software resources via networking software. 

log In 

To begin a session on the computer by entering the necessary information, 
such as your user name (login name) and password. 

login 

The login name by which you are known to the system. This may be any 
group of characters, as long as it meets system rules. 

NFS 

Network File Services. 

NFS file system 

A file system accessible over a network via the NFS Services product. 


Glossary-5 



NLSPATH 

An NLS environment variable used to indicate the search path for message 
catalogs. 

operating system 

The kernel (/stand/vmunix), commands, input-output control, system 
accounting, mass storage, and other services. 

owner 

The owner of a file is usually the creator of that file. Ownership of a file can 
be changed by the superuser or the current owner. 

parent directory 

A directory that contains other directories, each of which is then called a 
subdirectory. See also subdirectory. 

parent process 

In a shell environment, an existing process that has caused a new process (a 
child process) to be created. 

password 

An encrypted sequence of characters used by HP-UX to identify an 
authorized user and to permit authorized login on a system. 

path name 

Specifies the location of a particular file or directory within the directory 
structure by specifying the directories you need to pass through to get 
there. The directory names are separated by slashes. For example, 
/home/michael/myf ile is the path name for myfile. 

There are two kinds of path names. See also relative path names and 
absolute path names, and file name. 

permissions 

See access permissions. 

PID 

Process identifier (number). 

POSIX 

portable Systems Interface, complying with UNIX standards 1003.1 and 
1003.2 from IEEE. 
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POSIX Shell 

POSIX-compliant version of the Korn Shell, 
process 

An invocation of a program. Generally, process refers to a program running 
in memory, while program is the code (a sequence of instructions stored on 
disk that cause the system to perform some function). Several users can 
access the same program simultaneously. Each generates a separate process 
from the same program. 

process ID 

A unique identification number assigned to all processes by the operating 
system. Also see PID. 

prompt 

See command line prompt, 
read permission 

Users with read permission can view the contents of a file or directory. 

regular expression 

A string of characters that selects text. 

relative path name 

The name of a file, listing all the directories leading to that file in relation to 

the current working directory. 

For example, if you are in the /home directory, michael/myf ile is the 
relative path to /home/michael/myf ile. 

See also absolute path name, 
root 

See superuser, 
root directory 

The highest level directory of the hierarchical file system, from which all 
other files branch. In HP-UX, the slash (/) character refers to the “root 
directory. ” The root directory is the only directory in the file system that is 
its own “parent directory.” 

run-level 

The system state determined at boot that defines, among other things, multi- 
or single-user status. 
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SAM 

The HP System Administration Manager, a tool that allows you to perform 
many system administration tasks without having to know the specific 
HP-UX commands that are associated with the task. You must have 
superuser permission to run SAM. 

server 

A computer program that provides file access, login access, file transfer, 
printing and other services across a network. Sometimes, but not always, a 
server consists of a dedicated computer. 

session 

Generally describes the time between beginning to use an application and 
quitting the application. More specifically, used to describe the time between 
logging in and logging out. 

shell 

An HP-UX command interpreter (Bourne, Korn, Key, POSIX or C), providing 
a working environment interface for the user. The shell takes command 
input from the keyboard and interprets it for the operating system. 

software application 

A program used to perform a particular task, usually interactively, such as 
computer-aided design, text editing, or accounting. Style Manager, Text 
Editor, and File Manager are examples of software applications. 

standard error 

The destination of error and special messages from a program, intended to 
be used for diagnostic messages. The standard error output is often called 
stderr. Standard error usually appears on the display unless it is directed 
otherwise. 

standard input 

The source of input data for a program. The standard input file is often 
called stdin. Standard input is usually supplied by entering data at the 
keyboard. 

standard output 

The destination of output data from a program. The standard output file 
is often called stdout. Standard output appears on the display unless it is 
redirected otherwise. 
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subdirectory 

A directory that is located in, or anywhere on a path below, another 
directory, which is then called its parent directory. Sometimes called child 
directory. 

superuser 

A login that allows special permissions for modifying system flies that most 
users do not have permission to modify. Superuser is also called “the root 
user” or simply “root” since the user ID for superuser is root. On most 
computer systems, only a few users have permission to become superuser. 

System Administration Manager 
See SAM. 

system administrator 

The person responsible for system and network installation, updating, 
maintenance, and security at your site. 

user account 

The system administrator defines a user account for every person authorized 
to use the system. Each user account contains the name the computer uses 
to identify the person (user name) and the person’s password. See also user 
name, password. 

user name 

The name that identifies your account to the login program and to the mail 
systems and other software requiring secure entry. Sometimes called login. 

utility 

A program provided with the HP-UX operating system to perform a task, 
such as printing a file or displaying the contents of a directory. 

working directory 

See current working directory. 

write permission 

Users with write permission can change the contents of a file or directory. 
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Index 

A 

absolute path name, 2-18 
access control lists, 7-9 
accessing 
directories, 7-6 
flies, 7-6 

sensitive flies, 7-8 
access permissions, 7-6 
changing with chmod, 7-11 
ACL, 7-9 
adding 

peripherals, B-4 
printers, B-3 
address 
mail, 5-11 

advanced tasks, B-1 
alias 

creating, 5-13 
deleting, 5-14 
elm mailer, 5-12 
listing, 5-14 

system alias in elm, 5-12 
user alias in elm, 5-12 
alias command, A-2 
anonymous ftp, 6-3 
appending to a file, 2-12 
archive 

creating for mailing, 5-22 
arguments, command, 3-2 
auditing, 7-3 


B 

backing up flies or directories, B-3 
backups, B-3 
restoring, B-3 

backward scrolling in vi, 4-6 
backward searching in vi, 4-7 
books available, 1-10 
ordering, 1-10 
Bourne Shell 
features, 3-17 
obsolescence, 3-17 

C 

cal command, 3-3 
cancel command 
stopping a print job, 2-7 
canceling 

print request with cancel 
command, 2-7 
cat command 
creating flies with, 2-2 
terminating input, 2-2 
cd command, 2-24 
changing 

access to directories with chmod, 
7-14 

access to flies with chmod, 7-11 
directory with cd command, 2-24 
group of file, 7-10 
host name, 1-9 
IP address, 1-9 

owner of flies or directories, 7-10 
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password, 1-8 

properties of directory with chmod, 
7-14 

properties of file with chmod, 7-11 
run level, B-2 
shell, 3-19, 3-20 
time zone, 1-9 

user level in elm mailer, 5-25 
checking spelling 
with spell command, A-2 
chmod command, 7-11, 7-14 
chown command, 7-10 
chsh command, 3-20 
clear command, 7-3 
command help, 1-11 
command help online 
echo, A-2 
man, A-2 

command history, 3-23 
command interpreter, 1-2 
command line, 1-2, 3-3 
editing, 3-21 
help, 3-4 
help for, 1-11 
logging in, 1-5 
logging out, 1-7 
piping output and input, 3-14 
redirecting standard input, output, 
error, 3-10 

command mode in vi, 4-2 
commands 
arguments, 3-2 
editing command line, 3-21 
elm, 5-5, 5-27 

entering with Key Shell, 3-4 
line editing, 3-21 
multiple, 3-3 
options, 3-2 

re-executing in the POSIX Shell, 
3-23 

running at specified times, B-2 


running multiple on the same 
command line, 3-3 
running remotely, 6-16 
syntax, 1-11, 3-2 
commands (by name) 
alias, A-2 
cal, 3-3 
cancel, 2-7 
cat, 2-2, A-2 
cd, 2-24, A-1 
chmod, 7-14, A-3 
chown, 7-10, A-3 
chsh, 3-20 
clear, 7-3, A-4 
compress, A-1 
cp, 2-9, 2-26, A-2 
cp -r, 2-28 
date, 2-12, A-2 
diff, 2-11 
echo, 3-18, 3-31 
elm, 5-1, 5-27, A-1 
exit, 1-7, 3-19 
find, 2-35, A-2 
ftp, 6-3 
get, 6-5 
grep, 2-33, A-2 
head, 2-7, A-2 
kill, 3-8, A-4 
11, 7-7, A-3 
11 -d, 7-8, A-3 
Ip, 2-7, A-2 
Ipstat, 2-7 
Ipstat -t, A-2 
Is, 2-3, A-1 
Is -a, 2-4, A-1 
Isf, 2-22, A-1 
man, 1-11, A-2 
mkdir, 2-22, A-1 
more, 2-6, A-2 
mv, 2-9, 2-26, A-2 
mv -i, 2-9 
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passwd, A-3 
ps, A-4 
put, 6-7 
pwd, 2-16, A-1 
rep, 6-9 
remsh, 6-15 
rlogin, 6-13 
rm, 2-10, A-2 
rmdir, 2-29, A-1 
rm -rf, 2-30, A-2 
set, A-4 
shar, 5-22 
sort, 3-13, A-2 
spell, A-2 
tail, 2-7, A-2 
tee, 3-15 
TERM, A-4 
tset, 3-35 
umask, 7-15 
uncompress, A-1 
vi, A-1 
wc, 3-12 
who, 3-11 

comparing flies, 2-11 
compressing flies, A-1 
configuring 
elm mailer, 5-24 
set_parms program, 1-9 
contents 

finding file with grep, 2-33 
conventions, typographic, v 
copying 

directory with cp -r command, 
2-28 

file from remote system, 6-3, 6-5, 
6-11 

file to and from remote systems, 
6-9 

file to remote system, 6-7, 6-10 
file with cp command, 2-9 
remote directories, 6-11, 6-12 


correcting errors in commands 
Key Shell, 3-21 
POSIX Shell, 3-21 
cp command, 2-9, 2-26 
cp -r command, 2-28 
creating 

directory with mkdir command, 
2-22 

file with cat command, 2-2 
mail aliases, 5-13 

subdirectory with mkdir command, 
2-22 
C Shell 

features and information source, 
3-17 

current directory, 2-16 
changing with cd command, 2-24 
security, 3-33 
current message, 5-6 
current working directory, 2-16 
cursor 

positioning in the vi editor, 4-5 
customizing 
elm mailer, 5-24 

D 

date command, 2-12 
deactivating a user, B-4 
default 
printer, B-4 
shell prompts, 3-18 
defining 

mail aliases, 5-13 
deleting 

directory with rmdir command, 
2-29 

file with rm command, 2-10 
mail messages, 5-20 
text in vi, 4-4 
user accounts, B-4 
determining 
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location in directory hierarchy, 
2-17 

shell, 3-18 

diff command, 2-11 
differences between flies, 2-11 
directory 
accessing, 7-6 
backups, B-3 

changing owner with chown, 7-10 
changing who has access to, 7-14 
changing with cd command, 2-24 
copying flies with cp command, 
2-26 

copying with cp -r command, 
2-28 

current working, 2-16 
deleting with rmdir command, 
2-29 

hierarchy, 2-13 
home, 2-16 

listing flies in, 2-13, 2-20 
listing with Isf command, 2-22 
mailing, 5-22 
moving, 2-26 
navigating, 2-16 
organizing your flies, 2-13 
ownership, 7-10 
parent, 2-13 
path names, 2-18 
permissions, 7-6 
protecting with chmod, 7-14 
removing with rmdir command, 
2-29 

root (/), 2-14, 2-16 
security, 7-6, 7-14 
subdirectory, 2-13 
wildcard characters in directory 
names, 2-31 
directory hierarchy 
determining location, 2-17 
disabling a printer, B-3 


disk space 
recovering, B-2 
disk usage 
displaying, B-2 

DISPLAY environment variable, 3-26 
displaying 
disk usage, B-2 
file permissions, 7-7 
man pages, 1-11 
document 
creating in vi, 4-2 
editing in vi, 4-4 
opening in vi, 4-2 
saving in vi, 4-11 
documentation 
available, 1-10 
ordering, 1-10 

E 

echo command, 3-18, 3-31 
editing 

command line, 3-22 
text in vi, 4-2 
editor 
emacs, 4-2 
options in vi, 4-12 
third-party, 4-2 

EDITOR environment variable, 3-21, 
3-26 

electronic mail, 5-1 
addresses, 5-11 
aliases, 5-12 
current message, 5-6 
deleting messages, 5-20 
forwarding, 5-17 
mailing flies, 5-22 
reading, 5-6 
replying to, 5-15 
saving to a file, 5-19 
sending to users on other systems, 
5-10 
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sending to users on your system, 
5-8 

. elm directory, 5-24 
elm mailer, 5-1 
aliases, 5-12 
commands, 5-5 
command summary, 5-27 
creating aliases, 5-13 
deleting aliases, 5-14 
deleting messages, 5-20 
exiting, 5-21 

forwarding messages, 5-17 
getting help, 5-2 
listing aliases, 5-14 
main screen, 5-3 
options, 5-24 
packaging flies, 5-22 
reading mail, 5-6 
replying to messages, 5-15 
saving messages, 5-19 
sending mail, 5-8, 5-10 
starting, 5-2 
user level, 5-25 
elmrc file, 5-24 
emacs editor, 4-2 
enabling a printer, B-3 
entering 
commands, 3-2 

commands with Key Shell, 3-4 
text in vi, 4-2, 4-4 
environment, shell, 3-17, 3-25, 3-28, 
3-30 

environment variables, 3-30 
assigning values, 3-30 
definition, 3-25 
DISPLAY, 3-26 
EDITOR, 3-26 
HOME, 3-25, 3-33 
HP-UX, 3-30, B-4 
LOGIAME, 3-25 
MAIL, 3-25 


PATH, 3-25, 3-32 
PSl, 3-30 

SHELL, 3-18, 3-26, 3-31 
TERM, 3-26, 3-34 
TZ, 3-26 

EIV variable, 3-28 
errors 

printing, B-3 

escape character in vi, 4-7 
/etc directory, 3-32 
/etc/hosts file, 6-3, 6-10 
/etc/passwd file, 3-20, 3-25 
/etc/profile script, 3-28 
example 

command line editing, 3-22 
commands with arguments, 3-3 
commands with options, 3-2 
copying a directory to a remote 
system, 6-12 

copying a file from a remote system, 
6-11, 6-16 

copying a file to a remote system, 
6-10 

copying a remote directory to your 
system, 6-12 
elm mailer options, 5-25 
getting a file from a remote system, 
6-6 

putting a file onto a remote system, 
6-7 

sending mail, 5-11 
using local system from remote 
system, 6-14 
execute permission 
for flies, 7-6 

execute/search permission 
for directories, 7-6 
exit command, 1-7, 3-19 
exiting 
elm, 5-21 
ftp, 6-8 
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vi editor, 4-11 
exrc file, 4-14 


file 

backups, B-3 

changing access to with chmod, 
7-11 

changing group, 7-10 
changing owner with chown, 7-10 
compressing, A-1 
concepts, 2-1 

copying with cp command, 2-9 
creating with cat command, 2-2 
finding by contents with grep, 
2-33 

finding by name, 2-35 
inserting in vi, 4-16 
invisible file names, 2-4 
listing, 2-3 
mailing, 5-22 
managing, 2-1 
names, 2-4 
opening in vi, 4-2 
organizing in directories, 2-13 
ownership, 7-10 
permissions, 7-6, 7-11 
printing, 2-7 

protecting with chmod, 7-11 
removing with rm command, 2-10 
renaming with mv command, 2-9 
restoring, B-3 
security, 7-6 

transferring from remote system, 
6-5 

transferring to remote system, 6-7 
transferring with ftp, 6-3 
transferring with rep, 6-9 
uncompressing, A-1 
viewing contents of, 2-6 


wildcard characters (? and *) in 
file names, 2-31 
file system 

hierarchical, 2-13, 2-16 
filter programs, 3-16 
find command, 2-35 
finding 

file by contents with grep, 2-33 
file by name, 2-35 
text patterns in vi, 4-7 
forwarding message, elm mailer, 5-17 
forward scrolling in vi, 4-6 
forward searching in vi, 4-7 
ftp 

anonymous, 6-3 
command summary, 6-17 
creating directories, 6-4 
exiting, 6-8 
get command, 6-5 
listing directories, 6-4 
put command, 6-7 
starting, 6-3 

transferring files from remote 
system, 6-5 

transferring files to remote system, 
6-7 

ftp command, 6-3 

G 

GID, modifying, B-4 
global networks, 6-2 
graphical user interface 
VUE, 1-3 

grep command, 2-33 
group 

changing, 7-10 
modifying membership, B-4 
group membership of users, B-4 
guidelines 
file names, 2-4 
password, 1-8 
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H 

head command, 2-7 
help 

elm mailer, 5-2 
Key Shell, 3-4 
man pages, 1-11 

hierarchical file system, 2-13, 2-16 
hierarchy 
file system, 2-13 
$HOME/.cshrc, 3-29 
home directory, 2-16 
/HomeDirectory/. rhosts, 6-9 
HOME environment variable, 3-25, 
3-33 

$H0ME/.login, 3-29 
$H0ME/.profile, 3-29 
host name, 5-10 
setting, 1-9 
HP-UX 

command line, 1-2 
common commands. A-1-4 
manuals, 1-10 
quick reference. A-1-4 
security patches, 7-18 
System Administration Tasks, 1-10 
HP-UX directory hierarchy, 2-16 
HP-UX Reference manual pages, 1-11 
HP Visual User Environment 3.0 
User’s Guide, 1-10 
HP VUE, 1-3 
command line in, 1-2 
information sources, 1-4 
manuals, 1-10 

I 

including 
file in vi, 4-16 

information about your system, 1-10 
inserting 
file in vi, 4-16 
installing 


guide for, 1-10 
Installing HP-UX 10.0, 1-10 
peripherals, 1-10 
invisible file names, 2-4 
IP address 
setting, 1-9 

K 

Key Shell, 1-3, 3-4 
correcting errors in commands, 
3-21 

entering commands, 3-4 
line editing, 3-21 
using display, 3-4 
kill command, 3-8 

L 

LAN, 6-1 
leaving 
elm, 5-21 
ftp, 6-8 
vi editor, 4-11 

level of user, elm mailer, 5-25 
line editing 

choosing a command set, 3-21 
commands, 3-21 
Key Shell, 3-21 
POSIX Shell, 3-21 
setting vi, 3-21 
listing 

file permissions with 11 command, 
7-7 

files with Is command, 2-3 
11 command, 7-7 
11 -d command, 7-8 
local area networks, 6-1 
local login script, 3-28 
locating 

file by contents with grep, 2-33 

files using find, 2-35 

text patterns with grep, 2-33 
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location 

in directory hierarchy, 2-17 
logging in 

as superuser, 1-5 
at the command line, 1-5 
remote system, 6-13 
logging out 

at the command line, 1-7 
login program, 3-25 
login script, 3-28 
modifying, 3-28, B-4 
login shell, 3-20 

LOGIAME environment variable, 3-25 
looking at a file’s contents with more 
command, 2-6 
Ip command, 2-7 
Ip St at command 
getting printer information, 2-7 
Is -a command, 2-4 
Is command, 2-3 
Isf command, 2-22 

M 

mail, 5-1 
addresses, 5-11 
aliases, 5-12 

command summary, 5-27 
current message, 5-6 
deleting messages, 5-20 
forwarding, 5-17 
mailing flies, 5-22 
reading, 5-6 
replying to, 5-15 
saving to a file, 5-19 
sending to users on other systems, 
5-10 

sending to users on your system, 
5-8 

mail aliases, 5-12 
creating, 5-13 
deleting, 5-14 


listing, 5-14 

MAIL environment variable, 3-25 

mailing flies, 5-22 

making 

directory with mkdir command, 
2-22 

document in vi, 4-2 
file with cat command, 2-2 
managing 
flies, 2-1 

man command, 1-11 
man pages, displaying, 1-11 
manuals available, 1-10 
ordering, 1-10 
messages 
forwarding, 5-17 
reading, 5-6 
replying to, 5-15 
saving to a file, 5-19 
sending, 5-8 

sending to users on other systems, 
5-10 

misspelled words 
correcting with spell command, 
A-2 

mkdir command, 2-22 
modifying 

system parameters, 1-9 
more command, 2-6 
Mosaic, 7-18 
multiple 
commands, 3-3 
mv command, 2-9, 2-26 
mv -i command, 2-9 

N 

name 

finding file by, 2-35 
naming flies, 2-4 
national networks, 6-2 
network 
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computing, 6-1 
copying flies with ftp, 6-3 
global, 6-2 
local area, 6-1 
national, 6-2 
parameters, 1-9 

returning to your local system, 
6-14 

updating from network server, B-2 
wide area, 6-1 

Network File System, 6-1, B-2 
NFS, 6-1, B-2 
node name, 5-10 

O 

obsolescence of Bourne Shell, 3-17 
online help 
elm mailer, 5-2 
Key Shell, 3-4 
man pages, 1-11 
opening 

document in vi, 4-2 
file in vi, 4-2 
operating system 
commands, 1-2 
options 
command, 3-2 
elm mailer, 5-24 
vi editor, 4-12 

organizing flies in directories, 2-13 
owner of file 

changing with chown, 7-10 
Owner’s Guide, 1-10 

P 

packaging flies for mailing, 5-22 
.. (parent directory), 2-13 
password 
changing, 1-8 
guidelines, 1-8 
protecting, 7-4 


root, 1-5 

rules for choosing a new, 7-4 
security, 7-4 
superuser, 1-5 
patches, security, 7-18 
PATH environment variable, 3-25, 
3-32 

path for commands, 3-32 
path names, 2-18 
performance, system, B-2 
peripherals 
adding to system, B-4 
installing, 1-10 
removing from system, B-4 
permissions, 7-6 
access to sensitive flies, 7-8 
directories, 7-6, 7-14 
displaying directory access, 7-8 
displaying file access, 7-7 
flies, 7-6, 7-11 

listing access permissions with 11 
command, 7-7 

setting default permissions with 
umask, 7-15 

BID (process identifier), 3-8 
pipeline 

command input and output, 3-14 
Alter programs, 3-16 
POSIX Shell, 1-2, 3-25, 3-28 
command history, 3-23 
correcting errors in commands, 
3-21 

features, 3-17 
line editing, 3-21 
re-executing commands, 3-23 
printer 

adding to system, B-3 
default, B-4 
disabling, B-3 
enabling, B-3 

getting information on, B-3 
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removing from system, B-3 
status with Ipstat command, 2-7 
printing 

canceling print request with cancel 
command, 2-7 
errors, B-3 

with Ip command, 2-7 
print request 

canceling with cancel command, 
2-7 

status with Ipstat command, 2-7 
problems 

System Administration Tasks, 1-10 
process 
definition, 3-8 
killing, 3-8 

process identifier (BID), 3-8 
.profile file, 3-28 
modifying, B-4 
program, 3-8 
properties, changing 

directory with chmod, 7-14 
file with chmod, 7-11 
protecting 

directories with chmod, 7-14 
directories with umask, 7-15 
files and directories, 7-6 
files with chmod, 7-11 
files with umask, 7-15 
your password, 7-4 
PSl environment variable and shell 
variable, 3-30 
pwd command, 2-16 

Q 

quitting 
elm, 5-21 
ftp, 6-8 
vi editor, 4-11 
quoting arguments, 3-3 


R 

rep 

command summary, 6-17 
copying directories from a remote 
system, 6-12 

copying directories to a remote 
system, 6-11 

copying file from remote system, 
6-11 

copying file to remote system, 6-10 
rep command, 6-9 
reading mail, 5-6 
read permission 
for directories, 7-6 
for files, 7-6 
rebooting a system, B-2 
recalling previous commands, 3-23 
recovering disk space, B-2 
redirecting 

appending output, 2-12 
standard input, 3-11, 3-13 
standard input, output, error, 3-10 
standard output, 3-10, 3-13 
re-executing commands 
POSIX Shell, 3-23 
referencing HP-UX variables, 3-30, 
B-4 

relative path name, 2-19 
remote 

commands, running, 6-15 
computing, 6-1 
file system, 6-1 
login, 6-13 

remotely copying a directory, 6-9, 
6 - 11 , 6-12 

remotely copying a file, 6-5, 6-7, 6-9 
remote system 
copying files, 6-9 
copying files from, 6-5 
copying files to, 6-7 
creating directories, 6-4 
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listing directories, 6-4 
logging in, 6-13 
running commands, 6-16 
transferring flies with ftp, 6-3 
transferring flies with rep, 6-9 
removing 

directory with rmdir command, 
2-29 

file with rm command, 2-10 
peripherals, B-4 
printers, B-3 
user accounts, B-4 
remsh, 6-15 

command summary, 6-17 
renaming 

file with mv command, 2-9 
replace command in vi, 4-9 
replacing 
text in vi, 4-9 

replying to messages, elm mailer, 
5-15 
restoring 
flies, B-3 

restricted shells, 3-17 
.rhosts file, 6-9 
rlogin, 6-13 
command summary, 6-17 
logging in, 6-13 

returning to your local system, 
6-14 

rm command, 2-10, 2-30 
rmdir command, 2-29 
rm -rf command, 2-30 
root 

password, 1-5 
user, 1-5 

root directory (/), 2-14, 2-16 
rules 

password, 1-8 
run level, changing, B-2 
running 


commands, 1-2 

commands at specified times, B-2 
remote commands, 6-15, 6-16 

S 

SAM, 1-2, B-2 
saving 

document in vi, 4-11 
mail to a file, 5-19 
scripts 
login, 3-29 
.profile, 3-28 
scrolling 

documents in vi, 4-6 
searching 

flies using find, 2-35 
special characters in vi, 4-7 
text patterns in vi, 4-7 
text patterns with grep, 2-33 
search path for commands, 3-32 
search permission, 7-6 
securing your terminal, 7-3 
security 
auditing, 7-3 
default permissions, 7-15 
directories, 7-6, 7-14 
flies, 7-6, 7-11 

keeping your terminal secure, 7-3 
of current directory, 3-33 
password, 7-4 
sensitive flies, 7-8 
software patches, 7-18 
system, 7-2 

sending mail, 5-8, 5-10 
sensitive flies, security for, 7-8 
set command in vi, 4-12 
set_parms program, 1-9 
setting 

editor options in vi, 4-12 

host name, 1-9 

HP-UX variables, 3-30, B-4 
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IP address, 1-9 
login environment, 3-25 
password, 1-8 

search path for commands, 3-32 
selected permissions (ACLs), 7-6 
system environment, 3-28 
terminal characteristics, 3-35 
time zone, 1-9 
variables, 3-30 
vi editor defaults, 4-14 
setting line editor, 3-21 
shar command, 5-22 
SHELL environment variable, 3-18, 
3-26, 3-31 
shells, 1-2 

changing your shell, 3-19 
default prompts, 3-17 
default shell, 3-25 
differences, 3-17 
environment, 3-17, 3-25, 3-28, 
3-30 

features compared, 3-17 
file names, 3-17 
Key Shell, 1-3 
variables, 3-30 
variables, PSl, 3-30 
Shells: User’s Guide, 3-17 
showmode option in vi, 4-12 
single-quoting arguments, 3-3 
software security patches, 7-18 
sort command, 3-13 
special characters 
searching for in vi, 4-7 
spelling 

checking at command line, A-2 
standard error (stderr), 3-10 
standard input (stdin), 3-10, 3-11, 
3-13, 3-14 

standard output (stdout), 3-10, 3-13, 
3-14 
starting 


elm mailer, 5-2 
ftp, 6-3 
vi editor, 4-2 
startup 

set_parms program, 1-9 
status 

printer, using Ipstat, A-2 
print requests with Ipstat 
command, 2-7 
stopping 
elm, 5-21 

print request with cancel 
command, 2-7 
subdirectory, 2-13 
subshell, 3-30 

substitute command in vi, 4-10 
substituting 
text in vi, 4-10 
superuser, 1-5 
logging in, 1-5 
password, 1-5 
syntax 

commands, 1-11, 3-2 
mail addresses, 5-11 
system 

aliases, elm mailer, 5-12 
backups, B-3 
information about, 1-10 
login script, 3-28 
performance, B-2 

System Administration Manager, 1-2 
system administration tasks, B-1 
System Administration Tasks, 1-10 
system administrator, 1-2 
what to do if none available, 1-2 
system parameters 
modifying, 1-9 

system run level, changing, B-2 
system security, 7-2 
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T 

tail command, 2-7 
tasks 

advanced, B-1 

changing your password, 1-8 
editing in vi, 4-2 
finding system information, 1-10 
fixing errors in vi, 4-3 
logging in at the command line, 
1-5 

logging in on a remote system, 
6-13 

logging out at the command line, 
1-7 

printing, 2-7 

reading electronic mail, 5-6 
replying to electronic mail, 5-15 
running commands remotely, 6-15 
saving electronic mail, 5-19 
sending electronic mail, 5-8, 5-10 
system administration, B-1 
transferring files remotely, 6-3, 
6-9 

using electronic mail, 5-2 
tee command, 3-15 
TERM environment variable, 3-26, 
3-34 

TERM = (hp) prompt, 3-34 
terminal 

characteristics, 3-35 
windows, 1-3 

Terminal Session Manager, 1-3 
Terminal Session Manager: User’s 
Guide, 1-3 

terminfo database, 3-34 
text editors 
alternatives to vi, 4-2 
text mode in vi, 4-2 
text patterns 
finding in vi, 4-7 
time zone 


setting, 1-9 
transferring 
files with ftp, 6-3 
files with rep, 6-9 
troubleshooting 

System Administration Tasks, 1-10 
tset command, 3-35 
TSM 

information sources, 1-3 
Terminal Session Manager, 1-3 
typing 
in vi, 4-4 

typographic conventions, v 
TZ environment variable, 3-26 

U 

umask command, 7-15 
uncompressing files, A-1 
updating 

from network server, B-2 
Installing HP- UX 10.0, 1-10 
urgent message, sending with elm, 

5-9 

user 

deactivating, B-4 
user account 
removing, B-4 

user aliases, elm mailer, 5-12 
user information, modifying, B-4 
user level, elm mailer, 5-25 
user name, 3-20 
user’s guides available, 1-10 
/usr/bin directory, 3-32 
/usr/bin/sh program, 3-17, 3-25 
/usr/contrib/bin directory, 3-32 
/usr/lib directory, 3-32 
/usr/local/bin directory, 3-32 
/usr/share/lib/terminfo database, 
3-34 
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variables 
assigning, 3-30 

setting and referencing, 3-30, B-4 
vi editor 

command mode, 4-2 
cursor movement, 4-5 
deleting text, 4-4 
entering commands, 4-2 
entering text, 4-2, 4-4 
environment, 4-14 
errors, recovering from, 4-3 
["esc") , using, 4-2 
. exrc file, 4-14 
inserting file, 4-16 
quitting, 4-11 
replace command, 4-9 
replacing text, 4-9 
saving documents, 4-11 
starting, 4-2 

substitute command, 4-10 
substituting text, 4-10 
summary of essential commands, 
4-16 

text entry mode, 4-2 


viewing 

file with the more command, 2-6 
first lines of a file, 2-7 
last lines of a file, 2-7 
VUE (Visual User Environment), 1-3 

W 

WAN, 6-1 

wc command, 3-12 

who command, 3-11 

wide area networks, 6-1 

wildcard characters (? and *), 2-31 

windows 

for terminal users, 1-3 
Visual User Environment, 1-3 
workstation 
rebooting, B-2 
World-Wide Web, 7-18 
wrapmargin option in vi, 4-12 
write permission 
for directories, 7-6 
for files, 7-6 
writing 

standard input, 3-11, 3-13 
standard output, 3-10, 3-13 
WWW, 7-18 
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